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ABSTRACT 

The  analysis  of  software  system  requirements  is  to 
develop  a  complete,  consistent  and  unambiguous  statement  for 
what  the  software  will  do,  but  not  how.  Failure  to 
correctly  elicit  requirements  is  cause  for  difficult  and 
expensive  correction  efforts  during  later  phases  of  system 
development.  An  alternative  approach  to  interviewing  and 
textual  document  preparation  is  the  use  of  a  functionally 
limited  model,  a  prototype. 

This  thesis  will  examine  the  feasibility  of  using  proto- 
types accompanied  with  data  dictionaries  as  a  more  effective 
means  of  communicating  with  users  and,  therefore,  more 
correctly  eliciting  requirements.  It  will  include  develop- 
ment of  a  relational  based,  prototype  data  dictionary  using 
the  dBASE  II  database  management  system.  The  dictionary  is 
for  use  by  the  Deputy  Chief  of  Staff  for  Plans,  U.S.  Army 
Military  Personnel  Center,  Alexandria,  Virginia. 
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I.  INTRODUCTION 

The  analysis  of  requirements  has  been,  and  continues  to 
be,  a  source  of  difficulty  in  developing  software.   The 
impact  of  improper  analysis  is  far  reaching.   Consequently, 
considerable  effort  has  been  put  into  developing 
methodologies  to  elicit  and  accurately  capture  what  is 
needed  and  wanted.   The  traditional  strategy  for  conducting 
requirements  analysis  has  been  to  interview  users 
individually  and  then  to  document,  in  ordinary  English,  the 
users'  needs.   The  result  of  this  process  is  a  large  tome  of 
requirements  that  is  seldom  understood  in  its  entirety. 
However,  requirements  analysis  is  the  foundation  effort  for 
any  software  system  and  therefore  of  particular  importance 
for  achieving  project  success.   The  foundation  is  provided 
by  uncovering  the  flow  and  structure  of  data. 

The  software  to  be  built  it  described  by  several 
completion  of  several  actions.   Design  constraints  must  be 
identified   to  bound  the  problem  and  clarify  its  scope. 
Functions  and  data  mast  be  described  t   permit  an 
understanding  of  the  essence  of  the  system  to  be  automated. 
Interface  details  for  hardware,  software,  human  beings  and 
procedures  must  be  developed  to  integrate  the  software  into 
the  encompassing  system  or  organization.   Important  to 
describing  the  software  is  establishing  and  maintaining 
communications  with  both  the  eventual  user  and  the 
originating  requestor.   The  information  flow  and  structure 
becomes  a  tool  that  leads  to  an  overall  representation  of 
the  software  which  will  be  developed.   Thus,  the  design 
process  is  fed  the  output  of  the  requirements  analysis 
effort.   The  continuity  of  the  effort  and  the  quality  of  the 
design  are  heavily  dependent  on  the  requirement 
specification.   [Ref.  1] 
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There   are   several  problems    with    the    requirement    analysis 
effort   as  exercised    in   the    traditional    software    life   cycle. 
First,    users*    needs   may   change    significantly   during 
development.      This   can  occur   through    a   natural   evolution   of 
the    organization    or    through    interaction    with   the    software 
development   effort.       Secondly,    the   user  has  no   system   during 
the   period   between   the  solicitation    of  requirements   and 
delivery   of   the    completed   system-       The    user   has    no   clear 
picture   of   what    he   will   be   getting   because   he  has   only    been 
dealing   with  abstract  terms   and   representations,    nothing 
that    actually   behaves  like  the    real    system.      [Bef.    2] 

The   reasons    for    some   of   these   problems   are   known.      The 
people   involved   do  not   share   the  same   frames   of    reference 
because   analysts   and    end-users    coma    from   different    cultures. 
An   analyst   can    be   viewed   as    a    missionary   steeped    in   computer 
technology.      An   end- user    is    only  concerned    with    getting   the 
job    done   within    his    particular    business    area.      The   two 
usually   do   not    understand   each    ethers*    area   of    expertise   and 
a  great   deal  of    learning,    particularly   for   the   analyst,    must 
take    place.      The    product    resulting   from    the   interaction   of 
an   analyst   and    a   user  is   often    a  document    of   which   too   much 
is   expected.      The   medium   of    a    textual   document   may  capture 
many    relevant   details,   but   it    may   not  in    turn  communicate 
them    with  sufficient   clarity    to  permit    true    understanding. 
A   specification   document   is    often   too   long;    contains 
technical   terms    the    user   does  not    know;    contains    words    with 
different  meaning    to    users    and    analysts   and  often   also 
contains  trivia  and   motherhood    statements   which    sound  good 
but    offer  no   real   benefit.      A   textual   specification  can  be 
particularly   lacking   regarding    interactive    systems   because  a 
document  cannot   capture  the    dynamic    quality   of   the   user 
interaction. 

Nevertheless,    the  textual    document    as    a  requirement 
specification    is    the    basis   for    all   follow    on    work.       This 
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work  cannot  be  correct  if  its  basis  is  inaccurate.   Despite 
users  not  always  understanding  the  specifications,  they  are 
often  coerced  into  signing  and  approving  the  document 
because  the  developers  refuse  tc  go  forward  without  a 
signature.   The  developers  feel  it  is  necessary  to  have  user 
approval  and  the  requirements  frozen  to  prevent  having  to 
make  changes  which  increase  system  cost  further  along  in  the 
development  process.   However,  the  freezing  of  requirements 
specifications  causes  apprehension  for  both  users  and 
developers.   Developers  either  intuitively  feel  or  know  from 
experience  that  the  act  of  providing  what  an  end-user  needs, 
and  the  follow  on  design  and  coding  effort,  changes  his 
perception  of  those  needs.   The  solution  to  a  problem  can 
change  the  problem  [fief.  3].   The  essence  of  the  problem  of 
inadequate  requirement  specifications  is  the  incomplete 
communications  between  the  user  and  the  analyst.   The 
evidence  that  inadequate  communications  is  still  a  problem 
lies  in  the  fact  that  software  software  development  projects 
still  suffer  from  poorly  defined  specifications  despite  the 
considerable  effort  that  has  been  expended  in  in  developing 
and  using  rigorous  methodologies.   Some  observers  feel  the 
failure  rate  is  just  as  high  as  it  was  15  years  ago  and  that 
most  development  is  a  trial  and  error  process  [Ref.  4]. 

Requirements  specifications  can  take  one  of  three  forms. 
The  traditional  approach  is  to  develop  a  textual  list  of 
"shall  statements"  the  system  must  fulfill.   A  major 
disadvantage  of  the  textual  approach  is  the  psychological 
distance  from  what  the  user  will  eventually  receive.   A 
document  does  not  convey  a  realistic  sense  of  how  the  system 
will  fit  the  user' s  needs.   This  is  especially  true  for 
interactive  systems.   Textual  specifications  take  a  static 
view  in  attempting  to  capture  or  freeze  the  situation.   Most 
users  cannot  fully  describe  their  current  requirements  and 
even  fewer  can  identify  their  future  needs.   A  more  recent 
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innovation  is  the  use  of  an  interpretive  model.   An  example 
of  this  approach  is  the  Structured  Analysis  Design  Technique 
which  uses  a  set  of  graphical  representations.   Other 
interpretive  modeling  techniques  are  the  use  of  data  flow 
diagrams,  flowcharts  and  Nassi-Schneidermann  charts.   These 
approaches,  although  an  improvement  over  the  textual,  still 
do  not  adequately  communicate  on  line-interaction.   Using 
more  detailed  graphics  places  mere  burden  on  the  users  than 
it  helps.   However,  users  know  what  would  be  useful  if  they 
saw  it  [fief.  5].   A  useful  approach  is  to  develop  a  working 
model,  a  prototype.   The  development  of  higher  level 
languages  and  the  lessening  cost  of  hardware  have  recently 
given  rise  to  a  requirements  analysis  approach   which  offers 
promise  of  assisting  in  the  communications  problem.   This 
technique  is  prototyping. 

Chapter  2  is  devoted  to  explaining  the  concept  of 
prototyping.   A  key  to  successful  prototyping,  if  not  all 
systems  analysis,  is  the  capture  of  data  about  the  data  in 
some  form.   Data  dictionaries  are  the  means  most  often  used 
for  organizing  this  "metadata".   Chapter  3  will  discuss 
metadata  and  data  dictionaries  and  their  potential  role  in 
the  system  analysis  and  design  process.   By  explaining 
prototyping  and  data  dictionaries  we  will  show  the  two  as  an 
inseparable  pair  which  are  an  important  adjunct  to  the 
system  development  process.   The  culmination  of  this  thesis 
is  chapter  4  wherein  we  develop  a  general,  relational-based 
design  of  a  data  dictionary  for  use  with  prototyping  for 
requirements  analysis.   This  dictionary  will  be  implemented 
using  dbase  II,  a  micro-oriented  relational  database 
management  system. 


13 


II.  PBOTOTYPIMG  FOB  SOFTSABE  REO.UIREMEHTS 

A.   DEFINITIOH  OF  PROTOTYPING 

Webster's  dictionary  defines  a  prototype  as  one  of 
three  possible  things: 

1.  An  original  or  model  after  which  anything  is  formed 

2.  The  first  thing  of  its  kind 

3.  A  pattern,  an  exemplar,  an  archetype 

The  second  definition  is  probably  the  most  relevant  to  this 
discussion  because  prototypes  are  being  used  in  data 
processing  as  a  first  attempt  at  a  design  which  is  then 
extended  or  enhanced.  In  general  systems  development,  a 
prototype  is  known  as 


"...a  partially  complete  functional  model  of  a  target 
system  whose  purpose  is  to  provide  a  better  under- 
standing of  the  target  system's  reguirements"  [Ref.  6]. 


A  software  prototype  is  characterized  by  the  following 
features.   It  is  a  working  system,  although  of  limited 
capability,  rather  than  just  an  idea  on  paper.   A  prototype 
may  become,  after  iterative  enhancement,  a  production 
system.   Its  original  purpose  is  to  test  out  assumptions 
about  reguirements  and/or  systen  design  architecture.   A 
prototype  is  created  quickly.   This  has  become  possible  only 
in  recent  years  with  more  powerful  languages  which  are  less 
procedurally  oriented.   Some  would  argue  however,  that 
prototyping  was  the  way  software  was  developed  before  the 
advent  of  functional  decomposition  and  the  system 
dev  lopment  life  cycle  which  is  generally  accepted  and  used 
tod. 
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"In  the  early  days  of  software  development  writing 
programs  was  the  thing  to  do.   After  an  explanation  of 
the  problem,  a  period  of  questions  and  answers,  and 
research  into  the  nuts  and  bolts  of  a  method,  the 
programmer  began  his  or  her  work.   Starting  with  that 
portion  of  the  problem  that  was  well  understood,  lines 
of  FORTRAN,  COBOL  or  ALGOL  would  begin  to  appear.   As 
time  passed  additional  portions  were  coded  until  the 
entire  program  was  complete.   Design  was  conducted 
implicitly,  if  at  all!  "  [Ref.  7] 


A  prototype  should  be  inexpensive  to  build,  at  least  less 
than  it  would  cost  if  a  conventional  high  level  language 
were  used.  Indeed,  prototyping  in  data  processing  originated 
only  recently  because  until  now  programming  a  prototype  was 
just  as  costly  as  programming  the  working  system  [Ref-  8]. 
The  important  point  is  to  get  something  running  soon  to 
establish  effective  communications  with  the  user  without  the 
use  of  extravagant  resources.   The  follow  on  development  of 
a  prototype  is  a n  iterative  process  in  which  improvements 
are  made  in  small  increments  as  the  user  and  developer  work 
together  and  discover  new  requirements  [Ref.  9]. 

Mitchell  Spiegel,  formerly  of  Wang  Laboratories, 
explains  the  prototyping  approach  as: 


"...a  process  of  modeling  user  requirements  in  one  or 
more  levels  of  detail,  including  working  models. 
Project  resources  are  allocated  to  produce  scaled  down 
versions  of  the  software  described  by  requirements. 
The  prototype  version  makes  the  software  visible  for 
review  by  users,  designers  and  management.   This  process 
continues  as  desired,  with  running  versions  ready  for 
release  after  several  iterations.  "  [Ref.  10] 


Traditional  management  information  system  development 
follows  a  series  of  steps  (see  Figure  2.1).   Prototyping  is 
considered  as  an  adjunct  activity  to  the  specification  of 
requirements   (see  Figure  2.2).  The  results  of  prototyping 
are  input  to  the  steps  following  requirements  analysis,  but 
may  or  may  not  be  used  actively  in  those  steps. 

Three  alternatives  are  possible  for  the  disposition  of  a 
prototype.   Having  served  the  purpose  of  facilitating 
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requirements  definition  the  prototype  can  oe  discarded.   The 
lessons  learned  are  transferred  to  a  requirements 
specification  and  development  of  the  system  then  follows  the 
traditional  system  development  cycle.   A  second  alternative 
is  to  maintain  the  prototype  and  run  it  in  parallel  with  the 
developing  target  system.   The  benefit  of  this  choice  is  the 
availability  of  a  partially  functional  system  to  the  users 
until  the  fully  capable  system  can  be  delivered.   Lastly, 
the  prototype  can  continue  to  be  iteratively  refined  to 
become  the  target  system.   This  alternative  is  usually  only 
feasible  in  management  information  systems  as  opposed  to 
embedded  software,  such  as  weapon  control  systems  [Ref.  11]. 
Some  would  argue  that  the  term  prototype  should  only  be 
applied  to  those  instances  where  the  system  is  to  be  thrown 
away,  otherwise  it  is  more  appropriate  to  term  the  activity 
as  evolutionary  development  [Ref.  12].   The  purpose  of  the 
distinction  is  to  insure  that  only  the  right  decisions  are 
kept  and  transferred  to  the  requirements  specification  while 
the  mistakes,  especially  those  causing  poor  execution 
efficiency,  are  left  behind  with  the  prototype. 

B.   ADVANTAGES  OF  PROTOTYPING 


'■ 


There  are  several  advantages  associated  with  the  use  of 
prototyping.  The  primary  argument  for  using  prototypes  is 
that  the  specifications  which  result  are  more  complete 
because  users  can  evaluate  a  prototype  better  than  they  can 
evaluate  written  specifications.   In  using  the  prototype  the 
users  encounter  and  think  about  problems  they  will  have  with 
the  production  system  [Ref.  13].   Another  benefit  is  that 
prototyping  allows  and  encourages  asers  to  change  their 
minds  about  what  they  want.   Consequently,  the  eventual 
system  is  better  customized  and  therefore  more  useful.   This 
relates  to  the  idea  that  the  developmer.   process  itself 
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Feasibility  Study 
Requirements 
Product/  Preliminary  Design 
Detailed  Design 
Coding 
Integration 
Implementation 
Operations  and  Maintenance 


Figure  2.1    Steps  in  Traditional  System  Development 

changes  the  users'  perceptions  of  what  is  possible, 
increasing  their  insights  into  the  development  process  and 
affecting  it.   In  fact,  this  idea  is  a  loose  corollary  of 
the  Heisenberg  Uncertainty  Principle  which  states  that  any 
system  development  activity  inevitably  changes  the 
environment  out  of  which  the  need  for  the  system  arose 
—  [Eef.  14].   Some  argue  that  prototyping  eliminates  the 
/  surprises  at  the  end  of  the  traditional  development  process 

because  specifications,  some  being  erroneous,  haven't  been 
__frozen  and  pursued  without  correction.   Another  argument  is 
that  prototyping  shortens  the  development  cycle,  but 
experience  to  date  has  found  this  not  always  to  be  the  case 
and  that  prototyping  only  more  clearly  defines  what  has  to 
be  done.   Of  importance  to  those  suffering  with  technically 
oriented  data  processing  personnel  who  have  difficulty 
relating  to  people  is  the  benefit  that  prototyping  does  not 
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Figure  2.2    System  Development  Using  Prototyping 

require  interviewing  skills  to  the  same  degree  as  a 
traditional  method  of  defining  requirements.  Also,  because 
prototyping  requires  spending  more  time  with  users,  the 
systems  analysts  are  forced  to  become  more  user  oriented  and 
aware  of  the  user's  environment. 

The  emphasis  on  the  user  is  the  key  issue  hare  and 
further  benefits  are  possible.   The  availability  of  a 
prototype  enables  the  user  to  evaluate  the  human  interfaces 
in  practice  and  suggest  changes.   The  user  gets  a  more 
personalized  system,  regardless  of  the  efficacy  of  the 
changes  suggested.   Thus  the  user  is  more  willing  to  accept 
the  eventual  system  having  the  perception  that  he  truly 
affected  its  shape. 

A  working  prototype  enables  the  developer  to  evaluate 
the  users1  performance  with  the  human  interface  and  to 
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modify  it  to  minimize  errors.   Experimentation  is 
facilitated  by  implementing  alternative  interfaces  without 
having  to  suffer  the  tedium  of  drawing  specification 
graphics  of  one  sort  or  another. 

It  is  possible  to  generate  human-machine  dialogues  and 
to  make  minor  changes  quickly. 

The  existence  of  a  prototype  gives  the  user  a  more 
immediate  sense  of  the  proposed  system  and  encourges  him  to 
think  more  carefully  about  both  the  needed  and  the  desirable 
characteristics  of  the  system.   It  is  easy  to  write 
statements  in  a  requirements  document  which  say   "the  system 
shall  do  x"   and  "the  system  shall  be  capable  of  y". 
However,  both  the  developer  and  the  user  get  a  more 
realistic  feeling  for  the  effort  and  cost  of  a  feature  when 
they  must  actually  add  it  to  a  working  model.   Thus,  the 
eventual  model  better  represents  what  is  feasible  than  a 
document  with  a  series  of  "shall  statements".   It  is 
particularly  significant  to  note  that  in  a  typical 
development  effort  there  is  a  long  time  between  analysis  and 
construction.   The  user  only  has  a  limited  idea  of  what  the 
system  will  do  in  such  a  case.   Therefore,  it's  difficult 
for  the  user  to  be  specific  when  dealing  only  with  abstract 
terms.   Even  though  the  functionality  of  a  prototype  system 
is  minimal  the  user  is  forced  to  think  more  carefully  about 
the  task  being  automated.   This  should  produce  a  more 
accurate  understanding  of  the  problem  [Bef.  15].   The 
biggest  argument  for  prototyping  is  that,  unlike  traditional 
methods,   it  builds  an  effective  bridge  across  the 
communications  gap  between  the  user  and  the  analyst. 


C.   DISADVANTAGES  OF  PROTOTYPING 

Prototyping  has  some  decided  disadvantages  as  well. 
/Prototyping  makes  it  difficult  to  plan  resource  use  because 
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a  clear  path  of  what  you  will  be  doing  and  when  isn't 
provided.   It  also  makes  it  difficult  to  decide  whether  to 
enhance  an  old  system  or  build  a  new  one.   Analysts  and 
users  can  become  bored  after  the  nth  iteration  of  the 
prototype.   In  using  the  traditional  development  process 
there  are  specific  requirements  which,  when  met  by  proof  of 
validation,  clearly  mark  the  jot  as  complete.   Because  the 
prototype  is  changing  continually,  it  creates  a  problem 
keeping  users  abreast  of  the  current  version. 

Prototyping  can  cause  a  reduction  in  discipline  for 
proper  documentation  and  testing.   Because  there  is  less 
emphasis  on  hard  thinking  and  "desk  checking"   there  is  a 
greater  chance  of  missing  a  basic  problem  which  could  negate 
assumptions  essential  to  the  design  being  developed.   For 
large  systems  it  is  often  not  clear  how  the  problem  can  be 
divided  up  so  it  can  be  prototyped  a  piece  at  a  time  until  a 
traditional  requirements  study  has  been  made.   Mso  there  is 
the  chance  users  may  become  so  happy  with  the  prototype  they 
consider  it  a  functional  product  and  want  the  data 
processing  people  to  start  work  on  something  else.   This  can 
create  a  higher  initial  cost  for  the  requirements  phase  and 
possible  loss  of  the  distinction  between  this  phase  and  the 
design  phase. 

A  study  using  the  ACT/1  software  package  for  prototyping 
showed  increased  needs  for  computing  resources.   If  the 
productivity  gained  from  using  prototyping  doesn't  offset 
the  cost  of  the  increased  computing  power,  then  the 
prototyping  approach  is  serving  at  a  disadvantage. 
[Ref.  16] 

D.   APPLICATION  AND  GUIDANCE  FOR  PROTOTYPING 

Prototypes  can  be  usefully  applied  to  sevaral  different 
tasks  associated  with  requirements  analysis.   These  tasks 
are  as  follows  [Ref.  17]  : 
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1.  A  prototype  can  be  used  to  discover  the  optimum 
structure  for  the  data  about  data  (metadata).   This 
relates  to  the  engineering  use  of  prototypes  as  an 
experimental  model  from  nhich  to  learn. 

2.  The  prototype  can  serve  as  a  basis  for  bottom-up 
integration. 

3.  They  can  be  used  to  define  macros  that  compute  or 
derive  new  data  from  stored  data.   Abstracting  in 
this  manner  is  a  process  of  deriving  macros  from  a 
database.   The  database  is  enhanced  having  these 
macros  incorporated  into  it. 

4.  Prototypes  can  be  used  to  validate  domains.   This  is 
particularly  important  if  there  is  going  to  be  an 
active  data  dictionary  which  will  assist  in  ensuring 
data  integrity. 

5.  Prototypes  can  be  used  to  evaluate  both  update  and 
retrieval  efficiency. 

6.  They  can  be  used  to  improve  the  physical  database 
design. 

7.  They  can  be  used  to  anticipate  changes.   This  means 
to  conduct  experiments  and  step  through  what  the  user 
will  do  with  the  system  to  gain  insight  into  how  his 
use  will  foster  new  requirements,  be  they 
modifications  or  enhancements. 

8.  They  can  be  used   to  facilitate  implementation  and 
acceptance  of  a  new  system. 

If  any  of  the  items  listed  above  seems  sufficient  to 
warrant  a  prototype  then  several  conditions  should  exist  to 
make  prototyping  an  appropriate  choice.  These  conditions  are 
as  follows: 
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1.  The   user's   requirements    can    only    be    defined    with   much 
study. 

2.  The    user's   needs  are    expected    to   change    often. 

3.  The   user    is    willing    to   cooperate    with    the    prototyper 
in  answering    questions. 

4.  Users   are    willing    to    accept    the   prototype    as   an 
adequate    and    temporary   solution    until   an   optimized 
and    tested   system   can    be  delivered. 

5.  The   area    of   study    is    well   defined.       Although    in    depth 
aspects   of  a    problem    aren't   known,    the  width    or    scope 
is  confined    to  a   particular  business  area. 
Prototypes   aren't    appropriate    for    developing 
information   systems   strategies  for   an   entire 
enterprise. 

6.  The   user    has    a  limited    set    of    objectives.       Projects 
of  large    size   with   many    different    applications   areas 
are   not    appropriate   choices  for   use    of   the 
prototyping   methodology.      The   project   must   first   be 
functionally    decomposed    to  identify    specific   business 
areas. 

7.  A   data   dictionary   is   available  for    use.       Preferably 
an   automated,    easy-to-use  dictionary   is   available   to 
facilitate  easy  recording   of    specifications,    data 
entities,      procedures    and  whatever    else   is    necessary 
to  model    the    information   needs  of    the    user   [Eef.    18]. 

8.  Complete    honesty    exists    between    the    user    and    the 
prototyper.       If   the   user  isn't   satisfied,    he    should 
say   so   and   be   specific.    Further,    the   prototyper 
should   admit    ignorance   and    misunderstanding.       If   the 
answer   is   no    to  a   particular    feature   because   it    isn't 
technically    feasible,    it   should    be    so   stated   and 
explained,    not   ignored.      The   developer   must    be 
willing    to   interpret    user  difficulties   as    requiring 
re-examination  of    the    application,    rather    than 
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"educating"  the  user,  i.e.  converting  the  user  to  the 
developers  concept  [Ref.  19]. 

Regarding  the  last  point  above,  technical  people  are 
generally  deeply  involved  with  their  own  inventive  processes 
and  the  reasons  for  their  choices,  and  therefore  are  not 
inclined  to  consider  other  roads  which  also  admit  acceptable 
solutions. 

E.   TOOLS  FOE  PROTOTYPING 

Prototyping  to  define  system  requirements  is  a 
methodology.   A  methodology  is  a  combination  of  tools  and 
techniques  employed  within  an  organizational  and  managerial 
framework  that  can  be  consistently  applied  to  successive 
information  system  development  projects  [Ref.  20].   A 
requirements  analysis  tool  is  any  set  of  procedures,  manual 
or  automated,  that  guides  an  analyst  through  requirements 
specification.  A  manual  tool  is  a  well  defined  technique 
usually  with  a  mode  of  graphic  representation.   An  automated 
technique  is  often  a  specification  language  that  combines 
keyword  indicators  with  a  natural  language  feature.   There 
is  also  sometimes  a  specif icaticn  language  which,  when  fed 
to  a  processor,  produces  a  requirement  specification  and  a 
set  of  diagnostic  reports  concerning  the  consistency  and 
organization  of  the  specif icaticns  provided.   [Ref.  21] 

The  problem  with  currently  available  manual  and 
automated  systems  is  the  necessity  of  the  user  to  learn  some 
technical  features  to  use  the  tool.   An  argument  against 
these  techniques  is  that  the  end-user  should  not  be  burdened 
with  learning  about  the  data  processing  field.   Thus,  some 
would  argue  it's  beneficial  to  have  the  user  interact  only 
with  that  which  will  become  specifications  for,  if  not  part 
of,  the  eventual  system.   A  categorization  of  tools  for 
prDtotyping  has  been  made  and  offers  a  means  of  examining 
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what  is  available  for  use.   The  basic  requirement  for  any  of 
these  items  is  that  they  can  be  used  for  prototyping  if  they 
allow  designers  and  programmers  to  create  a  working  system 
in  a  short  period  of  time. 

The  first  category  of  tools  is  data  manipulation  systems 
or  data  base  management  systems  which  can  interface  with  a 
nonprocedural  language  to  do  data  manipulation  rather  than 
just  screen  presentation.   Such  products   as  RAMIS,  FOCUS 
and  NOEAD  are  examples  of  this  categorgy  of  tool  [Eef.  22]. 
Also  in  this  category  are  relational  data  base  management 
systems  which  some  feel  are  particularly  suited  for 
prototyping. 

Relational  data  base  management  systems  offer  a  high 
level  of  ease  of  use  and  data  independence,  both  of  which 
are  advantageous  for  prototype  development.   The  ease  of  use 
comes  from  the  simple  table  data  structures  and  the  query 
languages  associated  with  most  relational  systems.   Data 
independence  permits  simple  changes  to  logical  or  physical 
design  without  affecting  existing  programs  [Eef.  23]. 
Relational  data  base  management  systems  in  this  instance  are 
being  used  as  applications  generators.   Other  examples  of 
applications  generators  are  report  generators,  graphics 
packages,  statistical  packages  and  software  for  screen 
layout.   These  items  work  at  a  higher  level  than  another 
category  of  prototyping  tool,  program  generators. 

Program  generators  are  software  packages  which,  when 
given  specifications,  produce  source  listings,  usually  in  a 
high  order  language  such  as  COBCL,  capable  of  being  compiled 
and  executed.   Although  not  specifically   oriented  in  the 
requirements  definition  area,  they  do  provide  assistance  to 
requirements  definition  if  it  is  necessary  for  the  prototype 
to  do  actual  data  processing  These  are  particularly  helpful 
to  programmers  who  must   .nance  the    ototy  -  into  a 
production  system.   Such  program  gen   itors   re  not  in 
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proliferation  at  the  current  time,  but  a  sufficient  number 
exists  to  make  them  usable  in  some  development  efforts. 

Another  category  of  prototyping  tool  is  libraries  of 
reusable  code.   If  a  library  of  previously  written  routines, 
especially  screens,  exists  which  can  be  readily  implemented 
to  demonstrate  a  system's  limited  capabilities  then  the 
pratotyper  can  easily  pick  and  choose.   This  saves 
considerable  effort  and  speeds  along  the  process.   However, 
such  a  library  must  be  well  organized  so   that  the 
individual  building  the  prototype  can  readily  identify 
modules  which  suit  his  needs  and  can  move  these  modules  into 
the  developing  prototype  with  relative  speed.   This  implies 
the  code  used  has  been  well  documented  and  generalized  to  be 
applicable  beyond  its  original  intent.   The  prototyper  must 
be  able  to  maintain  momentum  with,  users  and  this  will  not 
happen  if  he  must  stop  to  develop  a  detailed  program. 
[Ref.  24] 

Hardware  as  well  as  software  should  be  considered  in 
developing  prototypes.   The  use  of  a  microprocessor  offers 
some  unigue  benefits  as  a  prototyping  tool.   A  micro  can  be 
beneficial  because  it  offers  a  cheaper  alternative  when 
considering  the  cost  of  acquiring  a  fourth  generation 
language  or  a  data  base  management  system  for  a  mainframe. 
A   micro  is  portable  and  therefore  can  be  taken  to  a  user's 
area  where  currently  no  terminals  exist.   The  micro  can  be 
left  for  the  users  to  play  with  and  discuss  at  their 
convenience  without  the  possible  dampening  result  of  having 
a  data  processing  person  around.   This  way  the  end  users  are 
not  imposed  on  by  disruptive  interviews.   Finally,  having  to 
actually  implement  the  features  provides  system  builders 
better  understanding  of  what  the  user  wants  and  avoids  the 
situation  of  just  adding  verbiage  to  a  requirements 
specification.   [Ref.  25] 
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P.   DATA  DRIVEN  PROTOTYPING 

There  exists  a  categorization  of  prototyping  techniques 
■which  divides  all  efforts  into  1  of  2  possibilities.   The 
first  category  is  termed  applications-oriented  and  describes 
the  situation  when  the  focus  is  on  transaction  modeling  and 
simulation  technology.   Most  people  who  belong  to  this 
school  believe  prototypes  should  be  thrown  away  rather  than 
carried  forward  and  evolved.   The  other  school,  the  data 
driven  category,  believes  prototypes  should  evolve, 
extending  the  architecture  of  the  business  in  a  process  akin 
to  learning. 

The  thought  is  that  requirements  analysis  should  be  an 
open  system  which  learns  from  its  experiences.   It  holds 
that  freezing  requirements  makes  for  a  closed  system.   A 
closed  system  is  not  responsive  to  the  user  and  therefore 
doesn*t  reflect  those  desires  which  will  make  the  system 
usable. 

The  data  driven  prototyping  technique  was  created  around 
an  abstraction  approach-   The  analysts  and  users  should 
abstract  from  an  entity  base  rather  than  decomposing  from  a 
functional  base.   The  data  driven  school  of  thought  contends 
that  functional  decomposition  is  not  realistic  because  its 
use  erroneously  assumes  requirements  can  be  precisely 
determined  before  system  construction  is  attempted.  The 
prototyping  approach  is  considered  valid  because  it  operates 
on  the  more  realistic  assumption  that  precise  requirements 
are  not  always  definable  until  after  construction  is 
started.    Some  argue  that  the  top  down  design  techniques, 
another  way  of  referring  to  functional  decomposition,  are 
imperative  in  nature;  that  is,  they  force  us  to  concentrate 
on  the  operations  in  the  solution  space,  with  little  regard 
for  discerning  data  structures. 
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The  major  difference  between  application  and  data  driven 
prototyping  is  that  the  latter  emphasizes  a  dominant  role 
and  value  for  data.   Data  prototypers  believe  entities  are 
the  essential  elements  of  learning  and  that  thsy  transcend 
individual  system  boundaries.   The  data  driven  school 
contends  that  functional  decomposition  is  not  realistic 
because  its  use  erroneously  assumes  requirements  can  be 
precisely  determined  before  system  construction  is 
attempted. 

The  prototyping  approach  is  considered  valid  because  it 
operates  on  the  more  realistic  assumption  that  precise 
requirements  are  not  always  definable  until  after 
construction  is  started.   They  assert  that  there  is  a  data 
life  cycle  distinct  from  the  traditional  systems  life  cycle. 
Further,  they  believe  the  degree  of  integration  of  systems 
is  a  function  of  how  much  data  are  shared  by  the  systems. 
Prom  these  concepts  it  is  the  job  of  the  prototyper  to 
discover   and  manage  the  integrating  data  in  the  most 
efficient  and  least  expensive  manner.   The  purpose  of  the 
data  driven  approach  is  to  develop  and  maintain  shared  data 
bases  (open  systems)  that  are  constantly  being  extended  to 
accommodate  new  information  requirements.   The  data  bases 
should  facilitate  the  extraction  and  synthesis  of  data  into 
useful  information  from  a  static  set  of  data  structures. 

Several  steps  are  required  to  apply  the  data  driven 
approach  to  a  particular  problem. 

1.  Operational  reviews  are  conducted  to  evaluate  the  "as 
is"  environment. 

2.  Conceptual  design  is  conducted  to  define  the  metadata 
structure  at  the  center  of  what  will  evolve. 
Scenarios  are  built  in  this  step  to  describe  those 
functions  for  changing  or  retrieving  the  metadata. 

3.  The  metadata  is  normalized  in  the  data  design  phase 
where  the  physical  organization  of  the  data  is  built. 
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4.  Heuristic   analysis   then    follows    where   requirement 
scenarios   are   exercised    against    the    metadata 
structures    using   real    data   values. 

5.  Environmental    testing    is  conducted    where    programs   are 
built   to    support    data    acguisition   and   population   of 
the   data    bases. 

6.  Quality   control  is   applied   via  use   of  performance 
modeling    to    ensure   the    system    not   only   reflects    the 
user's  desires  but   is    processing    in    a  realistic 
fashion. 

Proceeding  through  these  steps  requires  several  tools  such 
as  items  for  information  modeling,  activity  modeling, 
project  control,  a  relational  data  base  management  system 
and   a    data   dictionary.      [Ref.    26] 

G.       RELATION    BETWEEN    PROTOTYPING    AND    DATA    DICTIONARIES 

The   increasing   complexity   of   computer   systems   and   the 
growing   demand    of   management    that   computer   systems    justify 
their  cost   and    support  decision-making  calls   for    an 
integrated  tool    that   is  capable  of   recording   and    processing 
information.      This   information    describes   both  the   structure 
and    usage   of   all   the   enterprise's   lata   and    functions.       A 
data    dictionary    is    a    tool   that,    if   integrated   with 
prototyping   and    the    traditional   methodologies,    can   meet   the 
demands    of   complex   systems    and    management    [Ref.    27]. 
Prototyping   has    proven  so   successful   that    some  computer 
service   companies  have  been    developing   packages    to   provide 
prototyping   off    the   shelf.       Most  of    these    packages   assume 
the    existence    of   a    fully   descriptive    data    dictionary    or   else 
require   the   establishment   of    one   [Ref.    28].      Some    feel    that 
the   eventuality    of    extensive    networking    and    distributed 
processing    coupled    with   failure    to   properly   elicit    needr 
makes   it   imperative    that    data    dictionaries    be   integrate^ 
into    requirements   analysis   efforts   [Ref.    29]- 
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Figure  2.3    Integrating  Function  of  A  Data  Dictionary 

The  data  dictionary  that  results  from  requirements 
analysis  can  be  a  two-edged  sword.   It  can  become  both  a 
source  and  receptacle  for  the  prototyping  effort.   Without  a 
data  dictionary  of  some  type,  preferably  one  that  can  be 
used  as  an  adjunct  to  a  software  library,  the  analysis  task 
is  impossible.   The  dictionary  can  be  used  as  a  source  of 
information  necessary  for  prototyping  since  it  can  define 
entities,  attributes  and  relationships  at  a  conceptual 
level.   A  data  dictionary  can  contain  the  output  of 
prototyping  in  an  organized,  easy  to  manipulate  database 
instead  of  using  an  unwieldy  written  document  [Ref.  30].   In 
essence,  a  data  dictionary  should  be  at  the  center  of  the 
effort  and  serve  to  integrate  all  the  conceptual  output 
produced  by  the  tools  being  used. 
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III.  DATA  DICTIONARIES 

A.   DATA  CENTERED  SYSTEM  ANALYSIS 

An  understanding  of  the  rol€  data  dictionaries  play  in 
software  prototyping  first  requires  an  understanding  of  the 
underlying  philosophy  regarding  their  use.   This  philosophy 
is  a  data  centered  view  of  system  analysis  as  opposed  to  a 
process  centered  approach. 

Data  centered  system  analysis  treats  the  data  as  a 
separate  resource.   Processes  are  still  considered 
important,  but  the  target  of  all  processing  activity  is 
data.   An  aspect  of  this  approach  is  a  perception  of  data 
processing  as  a  succession  of  changes  to  data.   A  process  is 
viewed  as  a  series  of  data  changes.   The  data  centered 
approach  contends  that,  in  the  long  run,  designing  a  stable, 
well-documented  and  largely  non-redundant  structure  of  data 
provides  a  simpler  and  cleaner  forji  of  data  processing  than 
embedding  separately  designed  data  structures  into  many 
different  processes  or  applications  programs. 

Several  advantages  accrue  from  the  data  centered 
approach.   The  data  centered  approach  helps  avoid  problems 
with  file  proliferation,  mainterance,  data  redundacy  and 
data  inconsistency.   Once  the  appropriate  data  bases  are  in 
place,  some  types  of  applications  can  be  created  quickly 
with  high  level  data  base  languages.   Individual  users 
having  direct  access  to  the  data  bases  can  often  create 
their  own  reports  and  applications,  thus  avoiding  the  slow 
steps  of  formal  system  analysis.   Assembling  data  in 
different  ways  from  the  current  inventory  is  not  possible 
without  a  data  dictionary.   Data  administrators,  programmers 
and  users  cannot  realistically  be  expected  to  have 
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sufficient  knowledge  of  the  logical  organization  of  data 
bases  to  readily  pick  and  choose  data  as  needed  to  derive 
applications. 

There  are  distinct  disadvantages  to  the  data  centered 
approach.   The  data  bases  used  must  be  well  designed,  yet 
the  technology  of  good  data  base  design  is  often  not 
understood.   The  data  centered  approach  implies  the  sharing 
of  data  vhich  requires  different  management  from  that 
applied  to  a  collection  of  separate  files.   There  are 
conversion  problems  in  moving  from  the  traditional  process 
centered  to  the  data  centered  approach.   Some  of  these  are 
human  behavioral  problems  caused  by  users  losing  control  of 
data  they  previously  "owned".   The  cost  of  conversion  to  a 
data  base  environment  can  be  enormously  expensive.   The  data 
centered  approach  is  often  more  difficult  to  manage  in  its 
early  phases,  because  of  pressures  to  adopt  guick  alternate 
solutions  or  to  maintain  the  status  quo.   Once  set  up, 
however,  the  data  centered  approach  is  easier  to  manage  than 
a  process  centered  one.   Management  must  understand  these 
issues  clearly  for  the  approach  to  work. 

A  key  to  controlling  data  bases  and  facilitating  quick 
development  is  a  data  dictionary.   A  data  dictionary  can 
function  as  a  tool,  but  tools  should  not  get  in  the  way  of 
the  primary  goal:  solving  the  problem.   Any  tool  used  for 
requirements  analysis  must  contribute  to  managing  project 
complexity  rather  impeding  progress.   Capturing  the  data 
which  desribes  the  data  held  in  the  database,  the  metadata, 
must  be  a  smooth,  easy  process  which  does  not  burden  the 
momentum  of  discovery  built  in  working  with  users.   Users 
know  what  they  do  and  therefore  can  describe  processes  far 
easier  than  data.   Metadata  is  the  essence  of  the  means  of 
achieving  high  productivity,  shared  databases  and  reduction 
of  the  inefficiencies  associated  with  the  traditional 
development  process.   [ Ref .  31] 
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B.   METADATA 

Metadata  is  the  term  applied  to  that  data  which 
describes   other  data  or  databases.   Metadata  include 
descriptions  of  the  meaning  of  data  items,  the  ways  in  which 
the  data  are  used;  the  sources  of  particular  data  elements; 
the  physical  characteristics;  and  rules  or  restrictions  on 
their  forms  or  uses.   Some  choose  to  classify  metadata 
elements  into  3  types:   semantic,   physical  characteristic, 
or  usage  information.   [Ref.  32] 

Semantic  information  is  comprised  of  the  names  of  the 
component  or  entities.   A  unique  identifier  should  be 
assigned  to  each  component  even  though  it  may  be  known  by 
other  names.   These  other  names  are  called  aliases.   The 
documenting  and  tracking  of  aliases  promotes  data  sharing 
across  applications.   The  prevalence  of  aliases  should  not 
be  encouraged  or  discouraged,  but  should  be  accepted  as  a 
fact  of  life.   End-users  call  things  by  different  names  and 
a  data  dictionary,  as  an  adjunct  to  tne  database  which 
models  the  real  world,  should  accommodate  that  fact. 

Physical  characteristics  are  those  items  or  information 
which  describe  the  system  dependent  representation  of  the 
component.   The  length  in  bytes  of  a  data  element,  or  the 
access  method  for  a  particular  file  are  examples  of  physical 
characteristics.   This  category  includes  relationships  among 
systems  and  programs  which  use  the  database.   That  a 
particular  data  element  may  be  found  in  records  x,  y  and  z 
and  is  referred  to  by  programs  A  and  B  is  an  example  of 
physical  characteristic  metadata. 

Usage  information  illuminates  how  and  by  whom  data  are 
used.   This  type  of  information  enables  the  database 
administrator  to  trace  the  source  of  errors.   The  existence 
of  usage  information  also  permits  the  database  administrator 
to  assess  the  impact  of  changes  on  the  database  and  helps  to 
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develop  structures  to  monitor  and  control  access.   If  the 
scope  of  a  data  dictionary  is  widened  to  include  usage 
information  then  it  must  include  data  about  users  and 
processes  as  well  as  data  about  data  elements.   Processes 
can  be  performed  by  individuals,  organizations,  programs  or 
entire  systems.   A  process  can  be  a  single  transaction,   the 
generation  of  a  particular  item  such  as  a  report,  or  a  broad 
function  such  as  production  of  the  entire  monthly  payroll  to 
include  checks,  vouchers  and  a  summary  report  for 
management.   In  compiling  usage  information,  responsibility 
for  a  database  related  task  should  be  assigned  to  a 
particular  process  to  enable  monitoring  and  correction.   The 
source  of  a  transaction,  such  as  entering  the  number  of 
hours  worked  for  a  payroll  application,  should  be  documented 
and  traceable.  In  this  example,   a  clerk  may  be  used  to 
verify  and  enter  the  number  of  hours  worked.   [Bef.  33] 

Metadata  can  also  be  classified  as  one  of  three  types  of 
entities.   Entities  are  either  "real  world"  objects  or 
concepts  such  as  customers,  accounts,  salespersons  and 
orders.   Metaentities  can  be  classified  as  metadata 
entities,  metasystem  entities  and  meta-en vironment  entities. 
[Ref.  34] 

Entities  which  represent  data  objects,  such  as  data 
elements,  groups,  records,  files,  databases  or  reports  are 
examples  of  metadata  entities.   An  element  is  a  simple 
single  item  and  is  a  "primitive",  that  is,  it  cannot  be 
further  divided.   Elements  can  he  accumulated,  usually 
logically,  to  form  other  higher  level  metadata  entities  such 
as  groups  or  records.   A  savings  account  number  is  an 
example  of  a  data  element.  A  data  element  can  be  recursive, 
meaning  it  can  be  formed  or  conceived  as  consisting  of  other 
data  elements,  yet  for  purposes  of  the  particular 
application  cannot  be  further  subdivided.   A  savings  account 
number  may  be  separated  by  hyphens  when  printed  and  the 
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separated  parts  can  represent  different  meanings,  such  as 
branch,  type  account,  and  specific  customer.   However,  these 
different  numbers  will  always  be  carried  together  as  a 
singular  item.   [Kef.  35] 

Two  or  more  data  elements  can  be  collected  into  what  is 
called  a  group.   Groups  can  contain  other  groups.   The 
elements  or  groups  collected  to  form  a  group  are  usually 
logically  related  in  some  fashion.   Thus,  in  the  example  of 
an  address  group  the  elements  street,  city,  state  and  zip 
code  are  the  logically  related  elements  comprising  the 
group.  Groups  are  aggregations  larger  than  an  element  but 
smaller  than  a  record. 

A  record  is  a  collection  of  one  or  more  related  data 
elements  or  groups  that  is  treated  as  a  logical  unit.   Each 
employee  of  a  company,  for  example,  would  have  one  record 
and  it  would  be  a  collection  of  these  data  elements  and 
groups:  name,  department,  employee  number,  age  and  home 
address.   [fief.  36] 

A  file  is  a  set  of  occurrences  of  records  treated  as  a 
unit.   Different  types  of  records  may  be  contained  withia  a 
single  file,  or  it  can  contain   many  occurrences  of  a  single 
type.   An  occurrence  is  where  actual  values  nave  Deen 
assigned  to  the  fields  or  data  elements  of  a  record,  and  the 
record  therefore  now  models  the  reality  of  the  entity  on 
which  it  is  based.   [fief.  37] 

A  database  is  an  aggregation  of  D3MS  files,  records, 
groups  and  elements.   Databases  vary  in  both  logical  and 
physical  organization  depending  on  the  data  model  used  to 
design  the  database  and  the  DBMS  used  to  implement  the 
database.   [fief.  38] 

Reports  are  also  classified  as  metadata  entities 
although,  unlike  any  of  the  previously  discussed  entities, 
reports  are  usually  not  st   ed  but  produced  on  execution  of 
a  subsystem  or  program.   A  report  is  a  formatted 
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representation  of  information,  not  data.   Data  is 
manipulated  and  given  meaning  when  a  report  is  produced. 
Data  items  are  facts  which,  without  manipulation  and 
association  with  other  facts,  have  no  meaning  to  humans. 
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Figure  3.1    Hierarchy  of  Metadata  Entities 

Systems,  programs,  subroutines,  and  modules  are  all 
examples  of  metasystem  entities.    This  class  of 
metaentities  represents  processes  of  the  data  processing 
environment.   [Ref.  39] 

A  system  is  a  collection  of  related  programs  or  systems 
which  together  perform  a  set  of  functions  for  some  general 
purpose.   For  example,  a  payroll  system  might  consist  of 
many  programs:   one  for  producing  checks,  one  for  updating 
an  employee  database,  and  one  fcr  producing  a  summary 
report. 

A  program  is  a  collection  of  source  code  statements  (in 
assembly,  compiler,  query  or  fourth  generation  language) 
that  accomplishes  one  or  more  actions.   Programs  contain  one 
or  more  modules. 
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A  module  is  a  collection  of  executable  statements  which 
exists  to  accomplish  one  specific  application  function. 
Modules  are  the  result  of  software  being  divided  into 
separately  addressable  collections  of  source  language 
statements.   Modules  can  be  categorized  in  one  of  three  ways 
[Ref.  40]  : 

1.  Seguential  types  which  are  referenced  and  executed 
without  interruption  of  the  application  software. 

2.  Incremental  types  which  can  be  interrupted  before 
completion  and  restarted  at  the  point  of 
interruption. 

3.  Parallel  types  which  execute  simultaneously  with 
another  module  in  a  multiprocessor  environment. 

A  transaction  is  any  event  that  requires  the  database 
information  to  be  accessed.   Transactions  are  characterized 
by  type  (batch  or  on-line)  ,  frequency  (i.e.  number  of  times 
per  month) ,  and  use  (add,  delete,  modify) .  Transactions  are 
usually  thought  of  as  manual  actions  taken  by  a  user  which 
result  in  actions  being  taken  by  the  software  system. 

Interfaces  are  places  at  which  independent  modules, 
programs,  or  systems  meet  and  either  act  on  or  communicate 
with  each  other.  Interfaces  can  be  hardware,  software,  human 
or  procedural  components  of  a  system.   Most  often  there  is  a 
transfer  of  data  across  an  interface  which  must  be  clearly 
understood.   An  interface  description  should  provide  a  list 
of  all  data  that  enters  and  exits  a  component.   For  a  single 
module  the  description  should  indicate  what  data  moves 
across  an  argument  list,  any  external  world  input/output 
information  that  is  used  and  information  acquired  from 
global  data  items.   An  example  cf  an  interface  description 
for  a  module  which  calculates  the  miles  per  gallon  being 
used  by  a  digital  automobile  dashboard  system  would  look  as 
follows  [Ref.  41 ]  : 

Calling  protocol:    CALL  CALC-MEG (MPH,GPn, MPG) 
where 
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MPH   is    miles   per    gallon    (real, input) 
GPH   is    gallons  per   hour    (real,    input) 
MPG   is    miles   per   gallon    (real,    output) 

No    external    I/O   or    global    data  are   used 

CALLED    BY:       DATA-CONV-CTL 

CALLS:         no   subordinates 

The   environment   constitutes   another   category    of 
meta-entities.       This    category    can    be    divided    into    many 
different   items    if    it  is   desired   that    the    system    track    the 
equipment   configuration   as    well   as    the   data.    If    not,    then 
the    category    of    physical   devices   is    sufficiently    descriptive 
and    refers    to    such    items   as    a    CRT    terminal,    printer,    disk 
drive,    etc.      [Ref.    42] 

An   important   aspect    of   gathering    and   analyzing    metadata 
is   describing    it.    Descriptive    adjectives,    categories    and 
properties    of   an    entity    are    called   attributes.       Plagman   and 
Leong-Heong   cite   eight    generic    categories    of    meta-entity 
attributes: 

1.  Identification  attributes   which    designate,    describe 
or   somehow   identify   the    entity.       Entities    may    be 
known   by    more    than    one    name    depending    on    the    time, 
place   and    user's    frame    of   reference. 

2.  Relationship    attributes    denote   associations    between 
two    meta-entities.       For    example,    one   entity    may    be 
used   by    another.      Relationship   attributes    are 
sometimes    similar    to    interfaces.       A    link,    subroutine 
call,    access   path    or    mapping    qualify   as   a 
relationship    type   attribute. 

3.  Representation  attributes  describe    an   entity    as    it   is 
implemented.       A   data    element    is    represented   in    terms 
of    character     (alphabetic,    numeric    or    mixed),    source, 
or  length. 
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4.  Statistical  attributes  are  numerical  descriptions 
such  as  frequency,  estimated  life,  and  usage.   This 
class  of  attributes  are  useful  to  the  Database 
Administrator  in  assessing  the  impact  of  changes  and 
for  optimizing  queries. 

5.  Physical  attributes  help  describe  environmental  and 
system  entities.   Examples  are  storage  media,  storage 
size,  terminals  and  CPU  model. 

6.  User-defined  attributes  are  those  things  about  a 
particular  application  such  as  the  users,  analysts, 
designers,  customers,  etc.  that  are  helpful.   A 
"free-form"  attribute  is  included  in  this  category. 
This  is  often  implemented  as  a  comment  field  but  can 
be  specifically  named  if  the  user  desires. 

7.  Control  attributes  are  descriptors  for  how  restraint 
over  an  entity  is  exercised  such  as  security 
classification  or  edit  criteria. 

8.  Status  attributes  provide  the  life  cycle  status  of 
the  entity;  e.g.   candidate,  test,  operational, 
deleted  or  archived  [Ref.  43]. 

a)  A  test  status  means  the  entity  can  be  modified 
with  approv   of  someone  in  project  management.   A 
test  entity  is  not  for  production  runs  or  general 
use. 

b)  An  item  categorized  as  operational  is  being  used 
by  the  system  on  a  regular  basis.   Modification  of 
the  item,  especially  in  a  file  oriented  (as 
opposed  to  a  DBMS  oriented)  environment,  may  cause 
problems  and  therefore  is  carefully  controlled. 

c)  Archived  means  the  item  is  no  longer  used 
operationally  anywhere  in  the  automated  components 
of  the  system.   "Old  timers"  may  still  refer  to 
archived  entities  and,  therefore,  suet  items 
should  be  available  for  reference,  but  not  for 
use. 
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Indicating    the    status   of   a    meta-entity    is  important    for 
the    purposes  of    project  and   configuration   management.      It  is 
important  to  know   whether   a    simple   data    element,    a   program 
or   an   entire   system    is  either   under   development,    being 
integrated   or   operational. 

It   is   obvious   from   this    discussion    that    the    task    of 
managing  metadata   can  be   as   challenging   as    managing   the 
user's   data.      Consequently,    the  same    techniques   can   be    used 
to   manage  metadata,    that   is,    organizing   it    into    a   database, 
the    data   dictionary. 
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C.   DEF INITIOS  AND  OBJECTIVES  OF  A  DATA  DICTIONARY 

Familiarity  with  what  constitutes  a  data  dictionary  and 
the  purpose  for  having  one  are  reguisite  for  later 
understanding  of  its  role  in  requirements  analysis-   The 
need  for  documenting  data  is  obvious  and  grows  from  the 
universally  recognized  need  to  document  the  two  primary 
components  of  any  software  system,   functions  and  data.   A 
data  dictionary  is  a  repository  of  data  about  data  and 
processes  associated  with  a  particular  systems  development 
effort.   A  dictionary  often  includes  a  glossary  of  terms, 
data  characteristics,  process  descriptions,  and  some 
cross-referencing  mechanism. 

Data  dictionaries  come  in  three  different  forms. 

1.  The  data  documentation  for  a  system  can  be  made  a 
part  of  either  the  requirements  specification  or  a 
design  document. 

2.  A  data  dictionary  can  exist  as  a  separate  printed 
document. 

3.  A  data  dictionary  can  be  an  automated  data  base. 
Data  dictionaries  can  be  expanded  to  include  information 
about  the  physical  location  of  the  data.  In  that  case  it 
becomes  a  data  dictionary /directory.  If  either  the  data 
dictionary  or  data  dictionary/directory  uses  software  to 
store  and  access  the  data,  it  is  considered  a  system.  The 
following  delineates  feasible  manifestations  of  a 
diet  ionary : 

1.  A  data  dictionary  is  a  repository  for  data  about  data 
and  functions. 

2.  A  data  dictionary  system  is  a  software  system  to 
store  and  access  data  about  data  and  functions. 

3.  A  data  dictionary/directory  is  a  repository  about 
bo- h  logical  and  physical  information  for  data  and 
fu   tions. 
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4.   A   data   dictionary/directory  system   is   a   software 
system  to  store  and  access   both  logical  and  physical 
information  about  data  and  functions. 
Several  criteria  are  worth  examining  in  deciding  which 
way  to  document  data-   These  are: 

1 .  Estimated  size  and  complexity  of  the  system. 

2.  Extent  of  sharing  of  data  between  systems. 

3.  Use  of  a  generalized  DBMS. 

4.  Availability  of  automated  data  dictionary  software. 

5.  Number  of  data  descriptions. 

6.  Complexity  of  data  structures. 

7.  Volatility  of  data  descriptions. 

8.  Number  of  analysts  and  programmers  involved. 

9.  Number  of  organizations  involved. 

10-  Amount  of  clerical  assistance  available. 
11.  Uses  of  the  data  documentation. 

The  greater  the  number  and  strength  of  these  factors,  the 
earlier  a  decision  must  be  made  about  which  means  to  docu- 
ment data,  and  the  stronger  the  probability  that  that  means 
will  be  an  automated  system.  Regardless  of  form  a  data 
dictionary  should  document  several  different  components. 

All  files,  record  types,  items  within  records  and 
pertinent  information  about  the  use  of  the  data  should  be 
included  in  the  data  dictionary.   Pertinent  information 
includes  such  items  as  physical  description,  logical 
description,  and  functional  description  of  how  the  data  is 
used.   Further,  it  elaborates  on  how  the  data  is  changed, 
how  it  is  removed,  and  how  integrity  is  ensured. 

Based  on  the  information  the  dictionary  holds,  it  may 
satisfy  many  objectives  [Ref.  41].   Generally  any  data 
dictionary  should  provide  facilities  and  formats  for 
documenting  the  information  collected  during  all  stages; 
analysis,  design  and  implementation.   Further,  it  should 
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help  the  analysts  follow  any  of  the  structured  methodologies 
available  for  system  development.   Data  descriptions,  not 
only  processes,  should  be  traceable  back  through  program 
functions  to  the  original  statement  of  requirements.   The 
dictionary  should  be  readily  extensible  to  accommodate 
growth  or  expanded  application.   Its  existence  should  help 
achieve  the  establishment  of  a  glossary  of  terms  and  thus 
provide  for  standard  terminology.   Analysis  can  be 
accomplished  using  the  proper  terms  in  the  proper  context 
in  dealing  with  the  user's  particular  application  area. 
Semantics  are  important  for  both  understanding  the  user's 
area  and  for  tailoring  the  system  to  his  frame  of  reference. 
Modules  which  are  available  to  all  systems  should  be 
identified  via  a  generic  cross-reference  capability. 

Going  beyond  the  analysis  phase,  the  dictionary  can 
provide  assistance  in  generating  manageable  and  complete 
test  data.   Problems  which  arise  associated  with  aliases  and 
acronyms  can  be  resolved  via  a  data  dictionary.   As  an 
adjunct  to  configuration  management,  a  dictionary  provides 
centralized  control  for  system  changes.   Again  going  beyond 
the  analysis  phase,  a  dictionary  can  serve  as  a  reference 
and  guide  in  training  users  and  for  design  evolution. 
Maintenance  efforts  can  be  assisted  in  a  similar  vein  in 
that  programmers  unfamiliar  with  specifics  can  refer  to  the 
dictionary  as  a  guide. 

Having  met  a  majority  of  these  objectives,  a  dictionary 
should  be  capable  of  answering  several  questions  [fief.  45  ]# 
[Ref-  46]. 

1.  What  kind  of  validity  tests  have  been  applied  to  this 
data  type? 

2.  Who  is  authorized  to  update  this  data  itsm? 

3.  What  modules,  programs  or  systems  use  this  data  type? 

4.  What  are  the  valid  ranges  of  values  for  this  data? 
(domain) 
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5.   What  security  level  is  applied  to  this  item? 
6-   Who  is  allowed  access  to  the  data? 

7.  By  what  other  names  is  the  data  type  known  in  various 
application  environments?  (the  differences  should  be 
minimized) 

8.  In  what  reports  does  this  data  type  appear? 

9.  What  is  the  input  source  for  this  data  type? 

10.  What  are  all  the  data  items  used  by  a  given  program 
or  report? 

Data  dictionaries  may  have  problems,  particularly  if 
they  are  not  well  organized.   If  a  dictionary  is  fully  used, 
meaning  that  if  it  is  an  active  dictionary  which  serves  a 
controlling  function,  then  it  becomes  a  centralized 
controlling  facility.   Centralized  control  of  lata  is  not 
always  desirarable  or  appropriate.   For  a  data  dictionary  to 
get  to  this  point,  considerable  effort  must  be  expended. 
Therein  lies  another  problem  in  that  development  and 
implementation,  to  be  useful,  requires  careful  thought  and 
considerable  effort  £Eef.  47].   Another  problem  is  the  lack 
of  a  methodology  which  ties  the  use  of  a  dictionary  into  the 
overall  system  development  effort.   Dictionaries  need  to  be 
able  to  support  and  measure  the  documentation  progress. 
Unfortunately  the  means  of  describing  primitive  entities  in 
different  commercial  data  dictionary  packages  is  dissimilar. 
Few  dictionaries  have  specific  provisions  for  supporting  a 
structured  analysis  technique  [ Eef .  48].   Features  which  are 
important  for  database  design,  but  absent  from  many  current 
products  are  support  for  distinguishing  between  a  data 
element  and  its  domain  and  the  lack  of  a  graphic 
representation  capability.   In  response  to  these  problems 
this  thesis  proposes  that  a  model  that  is  easily  understood, 
the  relational,  be  used  to  organize  a  data  dictionary. 
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The  relational  model  is  appropriate  for  protoyping  with 
data  dictionaries  for  several  reasons.   As  discussed 
earlier,  the  ease  of  user  availability  of  query  language  and 
data  independence  make  relational-based  DBMS  good  tools  for 
prototyping.   The  relational  model  is  good  for  data 
dictionary  implementation  because  many  relational  DBMS  have 
a  "triggering"  mechanism  causing  a  program  to  be  invoked  on 
some  data  event  or  condition.   This  is  an  essential  feature 
for  a  data  dictionary  to  be  active,  that  is,  to  serve  as  a 
monitor  of  database  activity  to  ensure  data  integrity.   An 
additional  advantage  is  the  schemas  of  relational  systems 
are  tables.   This  can  reduce  the  work  required  to  implement 
the  dictionary  system.   For  these  reasons,  and  because 
relational  DBMS  are  now  available  for  microcomputers,  a 
prototype  data  dictionary  has  been  developed  and  is 
described  in  the  next  chapter. 
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IV-  A  DATA  DICTIOHABT  BASED  ON  THE  RELATIONAL  MODE 


A.   INTRODUCTION 

The  office  of  the  Deputy  Chief  of  Staff  for  Plans 
(DCSPLANS) ,  the  OS  Army  Military  Personnel  Center 
(MILPERCEN) ,  has  the  responsibility  to  develop  and  maintain 
computer  based  modelling  capabilities  to  support  personnel 
policy  development  for  the  Army.   DCSPLANS  has  subordinate 
branches  each  of  which  uses  and/or  maintains  models.   In  a 
prototype  effort  to  assist  DCSPLANS  organize  and  account  for 
these  information  resources,  a  relational  dictionary  system 
was  developed  using  the  dBase   II  relational  DBMS. 

The  prototype  system  is  capable  of  running  on  an  IBM 
Personal  Computer.   A  relational  based  DBMS  was  used  because 
of  the  features  previously  discussed.   A  microcomputer-based 
version  was  used  to  facilitate  transfer  of  the  prototype 
from  the  development  site  at  the  Naval  Postgraduate  School 
to  MILPERCEN  at  Alexandria,  VA. 

The  dictionary  accounts  for  several  different  relations 
including  reports,  offices,  models,  programs,  files, 
elements  (which  are  partitions  of  files,  rather  than  data 
elements)  and  fields.   The  generalized  format  of  these 
relations  is  as  follows: 

REPORT  (  rname,  full_name,  number,  status,  sec_class, 
output_format,  purpose,  description,  perdiodicit y) 

OFFICE (  of  c,  oname,  bldg,  room,  phone,  comments,  poc) 

MODEL  (  mdl,  model_name,  methodology,  status,  location, 
purpose,  description,  runame,  perdiodicity ) 
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PROGRAM  (   pname,    version,    location/    language,    purpose, 
description,    status,    perdiodicity) 

FILE  (  fname,    full_name,    last_update,    media,    status, 
sec_class,    purpose,    description,    poc) 

ELEMENT  (  elname,    version,    date,    seg_num,    size,    poc,    purpose, 
location) 

FIELD  (    fid,    length,    data_type,     cull_status,    source,    domain, 
description,    purpose,   status,    sec_class,    poc) 

For    a   detailed   explanation  of    the   attributes  for    these 
relations,    see    Appendix   B,       ita   Dictionary    Data    Elements. 

Relationships  amongst  the    various  relations   are   tracked 
by  having   relations   with   a  verb  name  reflecting    how    one 
entity   relates   to   another.       For  example,    since    a    MODEL    may 
be    used    by   many    different   OFFICES,    a    USES   relation   is 
included  in   the    dictionary-      Its  format  is   as  follows: 

OSES  {   ofc,    ename,    etype)  .      An    example  occurrence    of   this 
relation     would    be: 

USES (DAPC-PLF,     P3M,     MODEL) 

which   states   that   the  office    DAPC-PLF   uses    the   P3M    model. 

There   are   six    of    these   verb    type   relations.      In    addition   to 
the    USES   relation    these   are    CONTAINS,    MAINTAINS,    OUTPUTS, 
INPUTS,    and   CALLS.       The      generalized    format    of   each   of    these 
is    as   follows: 

CONTAINS  (   enamel ,    et  ypel .    ename,    etype) 

MAINTAINS (   ofc,    mdl,    model_poc) 

OUTPUTS  (  enamel,    ety  pel ,    ename,    et/pe) 

INPUTS  (    enamel ,    ety_£e_1,    ename,     etype) 

CALLS  (   enamel ,    ety_pej,    ename,    etype) 
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The  attribute  ename  stands  for  entity  name  and  the  attribute 
entity  type  stands  for  entity  type.   In  general,  these 
attributes  can  be  instantiated  fy  any  entity  (e.g.  model, 
program,  file,  element,  etc.)   The  specific  relationships 
these  relations  track  (see  Figure  4.1)  are  as  follows: 

1.  An  OFFICE  uses  many  different  REPORTS. 

2.  An  OFFICE  uses  or  maintains  many  MODELS. 

3.  A  MODEL  is  used  or  maintained  by  many  different 
OFFICES. 

4.  A  MODEL  calls  many  different  PROGRAMS. 

5.  A  MODEL  outputs  many  different  FILES. 

6.  A  MODEL  inputs  many  different  FILES,  i.e.   reguires 
many  different  FILES  as  inputs. 

7.  A  MODEL  outputs  many  different  REPORTS. 

8.  A  FILE  contains  many  different  ELEMENTS. 

9.  An  ELEMENT  contains  many  different  FIELDS. 

10.  A  FIELD  is  contained  by  many  different  ELEMENTS. 
There  are  two  special  relations  which  are  neither  pure 

entities  nor  verb  descriptors.   Thase  are  ALIAS  and 
CATEGORY. 

The  ALIAS  relation  provides  a  means  of  tracking  entities 
by  all  known  names.   Often  an  entity  is  given  one  or  more 
names  other  than  that  by  which  it's  officially  known.    For 
the  users  the  other  name,  the  alias,  is  the  natural  way  of 
referring  to  the  entity  and  therefore  the  dictionary  should 
accomodate  that.   The  Personnel  Policy  Projection  Model 
being  called  "pimmy"  is  an  example  of  an  alias. 

The  CATEGORY  relation  provides  the  basis  for  Key  Word  In 
Context  (KWIC)  capability.   Further,  it  allows  the  user  to 
categorize  different  types  of  entities  and  relate  them  in  an 
ad-hoc  fashion.   For  example,  if  several  files  and  programs 
were  the  responsibility  of  a  particular  programmer  to  audit, 
all  those  different  entities  could  be  entered  as  category 
records  with  that  programmer's  name  as  the  particular 
category. 
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The  format  of  the  ALIAS  and  CATEGORY  relations  is  as 
follows: 

ALIAS  (  ename,  etv.Ee,  aname) 

CATEGORY  (  ename.  ety.£e,  cat) 


1   REPORT 

«-- 

>>)  OFFICE 

1 

-i «. t 

MODEL 

T 

V 

T 

V 

J  PROGRAM 

| 

1   FILE 

1 

t 

V 

ELEMENT   1 

7f 

V 

FIELD    1 

Figure  4. 1    Bachaan  Diagram  of  Entities 

Structuring  the  metadata  as  shown  above  offers 
advantages  for  ease  of  learning  and  using  the  data 
dictionary.   The  logical  structure  is  based  on  a 


43 


commercially  successful  data  dictionary  system,  DataManager. 
The  data  dictionary  is  a  database  and  therefore  models  the 
real  world  in  a  limited  fashion.   By  taking  a  data-centered 
viewpoint  wherein  all  entities  are  categorized  as  either 
objects  (i.e.  models  or  reports),  or  processes  (i.e.  uses, 
contains,  maintains)  which  act  on  objects,  an 
easy-to-understand  model  emerges.   Consequently,  use  of  the 
dictionary  is  facilitated  so  that  it  becomes  a  tool,   rather 
than  a  burden  to  the  data  system  developer /maintainer/user. 
This  will  be  substantiated  by  the  following  discussion  of 
the  system  structure  and  query/report  capabilities. 

B.   SYSTEH  STRUCTURE  AID  USER  INTERFACE 

The  software  of  the  system  was  structured  to  provide  all 
the  possible  functions  one  might  wish  in  a  database  system. 
These  are  the  ability  to  add,  change,  or  delete  records  and 
to  provide  reports  and  queries  (see  Figure  4.2)  .   Because 
the  system  is  a  prototype  and  specific  user  naeds  are 
unknown,  all  functions  are  provided.   Depending  on  user 
feedback  and  observations  made  by  the  analyst,  these 
functions  can  be  expanded  to  offer  different  dialogues  or  be 
converted  to  batch  procedures. 

The  user  interface  for  any  interactive  system  is  an 
important  criterion  for  success.   Because  a  data  dictionary 
system  should  be  a  tool  to  facilitate  software  system 
development  and  maintenance,  it  should  provide  a  friendly 
user  interface.   This  data  dictionary  system  is  menu  and 
prompt  driven.   The  software  prompts  for  all  necessary  data 
and  actions  to  develop  and  maintain  intersection  records 
(in  this  system  called  processes  or  verbal  relations  such  as 
CONTAINS  or  USES).   Consequently  the  user  manual  for  the 
system  is  not  a  long  and  trying  document  to  use. 
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1 

MAIN    MEND 

1 

ADD 

CHANGE 

DELETE 

1 

QUERY 

REPORT 

MENU 

MENU 

a  mo 

MENU 

MENU 

add-model 

chg- model 

del-model 

f ortrev 

sumod 

add-off ice 

chg-office 

del-office 

baktrev 

sumrep 
sumfil 

add-report 

chg- report 

del-report 

foral 

add- pro gram 

chg- program 

del-program 

bakal 

sumof f 

add- file 

chg-iile 

del-file 

forcat 

sumrep 

add- element 

chg- element 

del-element 

bakcat 

add- field 

chg- field 

del-field 

add-alias 

chg-alias 

del-alias 

add-category 

chg-category 

del-category 

...   , . 

Figure  4.2    Hierarchical  Chart  of  Software 

The  guery  interface  is  particularly  friendly.   The 
system,  named  dDICT  II,  provides  two  types  of  gueries, 
forward  and  backward.   Forward  Beans  the  user  is  presented 
columns  of  relations  from  which  to  pick.   The  columns, 
following  the  forward  flow  of  the  English  language,  are 
subject,  verb  and  objects.   The  user  provides  the  unigue 
name  of  an  entity  beside  its  tyj.e  in  the  subject  column; 
marks  1  appropriate  verb  column  and  1  appropriate  object 
column.   For  example,  to  answer  the  guestion  "What  models 
does  the  office  with  symbol  DAPC-PLF  use  ?"   the  Figure  4.3 
depicts  how  the  screen  of  the  FCRTREV  program  would  appear. 
The  Figure  4.4  depicts  how  output  from  this  guery  would 
appear.   Verb  and  object  choices  must  be  appropriate  for  the 
subject  in  that  it  is  not  possible  to  get  any  response  from 
a  guery  marked  for  which  there  is  no  relationship  defined. 
Foe  example,  marking  the  screen  of  the  FORTREV  program  to 
answer  the  guestion  "What  models  contain  what  fields  ?  " 
would  elicit  no  response  when  processed. 
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SUBJECTS 

VERBS 

OBJECTS 

Office:DAPC-PLF 

• 

Uses:X: 
Maintains:    : 

Reports: 
Models: X 

• 
* 

Model: 

• 
• 

Calls:    : 

Inputs:    : 

Outputs:    : 

Programs: 
Files: 

• 

File: 
Element: 

• 
• 

• 

Contains:    : 

Elements: 
Fields: 

• 
• 

To    quit   put    an 

X 

in    this    field 

•        * 

Put   the    unique   name  of  the   entity    you 
in   the  field    next    to   the    entity's   typ 
in   one   appropriate  verb   field  for   tna 
an   X   in   1    appropriate   object   field. 
I.E.    Office: DAPC-PLF        :            Uses:X: 
To   process   query   move   cursor   through 
fields   using    RETURN   key. 

are  querying  about 
e.      Then    place    an   X 
t    entity    type  and 

Models:X : 
remaining 

Figure   4.3        Example   of  a   Forward  Retrieval 


The   office   DAPC-PLF   uses      the   following    models 

P3M 
OAS 

Strike  any  key   to    continue... 

WAITING 


Figure   4.4        Sample   Output    From   a   Forward  Retrieval 

The      backwards   approach   is    implemented    by   presenting 
from    left   to   right    columns   of    objects,    verbs   and    then 
subjects.      Thus,    to    answer    a   question   such    as   "What    offices 
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use  the  P3M  model  ?"   see  Figure  4.5  for  how  the  the  screen 
of  the  BAKTREV  program  would  be  marked.   This  query  will 
produce  the  unique  names  of  the  offices  that  use  the  P3M 
Model  and  Figure  4.6  shows  how  the  output  would  appear. 


OBJECTS 

Model: P3M 
Report: 


Program: 
File: 


Element: 
Field: 


VERBS 

Is   used   by:X: 
Is   maintained  by:    : 


Is    called   by: 

Is   inputted   by: 

Is  outputted   by: 


Is  contained   in: 


To   quit  put   an    X  in    this    field:    : 


SUBJECTS 


Office:X 

Model: 

File: 
Element: 


Enter  the  name  of  the  entity  besides  its  type  and  then 

mark  1  verb  field  and  1  subject  field.   To  process 

query  move  cursor  down  through  remaining  fields 
using  RETURN  key. 


Figure  4.5    Example  of  a  Backward  Retrieval 

Because  the  ALIAS  and  CATEGORY  relations  are  each  a 
special  case,  they  are  given  their  own  respective  forward 
(FORAL  &    FORCAT)  and  backward  (EAKAL  &  BAKCAT)  query 
programs.   For  example,  if  you  wish  to  know  all  the  aliases 
that  exist  for  all  models  in  dDICT  II  you  would  execute  the 
FORAL  program  and  mark  the  menu  as  in  Figure  4.7  and  Figure 
4.8   shows  how  the  output  would  appear. 

If  you  wish  to  know  all  aliases  for  an  entity  for  which 
you  knew  the  name  you  would  use  the  BAKAL  query.   For 
example,  if  you  wanted  to  know  all  the  aliases  for  the  P3M 
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The   model 

P3M 

is 

used 

by 

the 

f 

ollowi 

ng 

off 

ices 

DAPC-PLP 
DAPC-PLT 
DAPC-PLS 
DAPC-PLF 

Strike  any 
WAITING 

key 

to 

continue 

•    *  m 

Figure  4.6    Output  From  a  Backwards  Retrieval 


1 

i 

Model:X 

File:    : 

Program:    : 

Element:    . 

Report:    : 

Field:    : 

Enter  an   X 
for   which   \ 
field. 

in 
rou 

the 
want 

field 
all 

beside   the   type 
names   and   aliases 

of   entity 
.    Mack   only 

1 

Figure  4.7   Example  of  FORAL  Menu 

model  you  would  mark  the  menu  of  the  BAKAL  query  as  in 
Figure  4.9  and  Figure  4.10  shows  how  the  output  from  that 
query  would  appear. 

The  FORCAT  program  permits  you  to  determine  all 
occurrences  of  a  type  of  entity  and  in  what  category  each 
occurence  falls.   For  example,  if  you  wish  to  know  what 
models  had  teen  categorized  in  some  way  see  Figure  4.11  for 
how  to  mark  the  menu  of  the  FORCAT  program.   Figure  4.12 
depicts  how  the  output  would  appear.   See  Figures  4. 13 
and  4.14  regarding  use  of  the  BAKCAT  program. 
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I   The  following  models  have  the  associated  aliases 
I 

P3M  PIMMY 

P3M  PAIN 

OAS  ASSETEE 

Strike  any  key  to  continue  . .. 

WAITING 


Figure   4.8        Example   of   Output   From    FORAL    Query 


Model: P3M  :  File: 

Program:  :  Element: 

Report:  :  Field: 

Enter   the   name    of    the   entity   in   the   field 
beside   its    type.       Provide   only    1    name. 


Figure   4.9        Example  of   BAKAL    Program 


The   model   P3M  has   the    following   aliases 

PIMMY 
PAIN 

Strike  any  key  to  continue  . .. 
WAITING 


Figure  4.10    Example  of  Output  from  BAKAL 
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Model:X: 
Program: 
Report: 


File: 

Element: 

Field: 


Enter    an    X   in    the    field   besides   the    type    of 
entity   for    which    you    want    all  names    ana   associated 
category.    Mark   only    1    field. 


Figure  4.11         Example    of    Menu    for    FORCAT  Program 


The   following   models   are    in    the   associated  category 
OAS  OFFICER 


Strike  anv   key   to    continue 

WAITING 


Figure  4.12    Example  of  Output  From  FORCAT 

For  more  extensive  information  about  a  particular  Model, 
File,  Office,  or  Report,  the  Report  subsystem  exists.  This 
subsystem  has  a  menu  from  which  the  user  selects  the  type  of 
report  program  to  execute.   The  system  will  then  prompt  the 
user  for  the  unigue  name  of  an  entity*   From  that  the  system 
will  then  provide  a  printed  summary  report  which  provides 
all  entities  which  have  a  direct  relationship  with  the 
entity  named.   Thus,  if  the  user  provides  the  unique  name  of 
a  Model,  the  printed  report  would  list: 
1.   All  offices  which  use  the  Model. 


55 


-. 

Model:OAS             :                                File:                                : 

Program:                                  :           Element:                            : 

Report:                         :                           Field:                              : 

Enter   the    name    of    the   entity   in   the   field    beside    its 
type.    Provide   only   1    name. 

Figure  4-13        Example    of    Menu    for    BAKCAT   Program 


The    model  OAS        is  in   the    associated   category 

OFFICER 

Strike  any  key  to  continue 
WAITING 


Figure  4.14    Example  of  Output  for  BAKCAT  Program 

2.  All  offices  which  maintain  the  Model. 

3.  All  programs  the  Model  calls. 

4.  All  reports  the  Model  outputs. 

5.  All  files  the  Model  either  inputs  from  or  outputs  to. 
For  example,  if  you  wished  to  have  a  summary  report  for  the 
P3M  model  you  would  select  option  1  from  the  Reports  menu 
for  execution  of  the  SUMOD  program.  The  system  would  then 
prompt  you  as  follows: 

Please  enter  the  unique  name  of  the  Model 
Hit  the  space  bar  and  RETURN  to  guit:P3M 

Figure  4.15  shows  how  the  output  would  appear. 
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_____ __ 

The    Model      P3 M 

Is   used    by  the   following    offices: 

DAPC-P1P 
DAPC-PLT 
DAPC-PLS 
DAPC-PLF 

Is    maintained   by    the   following 
the   point   of   contact: 

offices    with 

DAPC-PLF      KALINICH 

Inputs  the   following   files: 

P3MDATA 

Outputs   to   the   following    files: 

P3M0UTPUT1 

Outputs   the    following   reports: 

EPMR 
P3MHEP1 

Calls  the   following  programs 

P3UPE0GUN01 
P3MPR0GD0S1 
P3MPRCGTRES1 

Strike   any    key    to   continue 
WAITING 

Figure  4. 15   Example  of  Report  Output 

Providing  these  $uery  and  report  capabilites  makes  the 
dictionary  more  than  a  repository  but  a  fully  capable  tool. 
Dse  of  the  dictionary  to  manage  data  is  not  merely  made 
possible  but  truly  facilitated.   The  data  administrator  can 
quickly  input  or  retrieve  metadata  as  appropriate   to  impose 
order,  control  and  effective  management  of  a  critical  part 
of  the  organization's  resources.   Implementation  and  use  of 
a  dictionary  marks  an  important  step  in  an  organization 
towards  knowing  what  data  assets  it  has  and  most 
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importantly,  what  data  assets  it  needs.   Needs  are 
requirements  the  specification  of  which  must  be   precise  to 
be  implementable.   For  example,  knowing  exactly  what  fields 
occur  in  what  elements  and,  therefore,  what  else  we  need  to 
accomplish  some  function  is  a  critical  question  to  be 
answered  in  defining  requirements.   Having  an  automated  and 
interactive  means  of  answering  such  questions  provides  a 
decided  advantage  over  using  textual  documents.   This 
dictionary  thus  provides  an  important  tool  from  which  the 
data  administrator  can  more  expeditiously  manage  the 
organization's  current  data  processing  capabilities. 

Because  the  user  of  this  dictionary  is  located  across 
the  country  from  the  development  site,  a  demonstration 
version  of  the  dictionary  was  created  and  populated  with 
example  data  (see  Figures  4.16  and  4.17).   The  demonstration 
version  can  be  used  to  learn  the  capabilities  of  the  system 
without  fear  of  destroying  anything.  Once  confident  with  the 
operation  of  the  demonstration  version,  the  user  can  migrate 
to  the  production  version. 

Because  dDICT  II  is  a  prototype  it  is  missing  features  a 
refined  and  full  production  system  would  have.   Most 
importantly,  the  software  doesn't  enforce  relational 
constraints.   Thus,  seme  entities  can  be  present  without 
others  also  being  present.   For  example,  a  program  can  exist 
without  there  also  existing  a  model  which  calls  that 
program.   It  remains  to  be  determined  how  important  it  is 
for  metadata  integrity  to  have  the  software  enforce 
relational  constraints.   Further,  dDICT  II  does  not  enforce 
what  can  be  entered  for  a  particular  attribute  of  an  entity. 
Because  many  of  the  attributes  contain  narrative  text  it  is 
not  possible  to  develop  precise  logic  for  what  can  and 
cannot  be  entered.   However,  this  is  a  refinement  which 
should  be  a  ied   :ce  the  user  has  migrated  to  the  production 
version  and  populated  it  with  real  metadata.   The  attributes 
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■ 

Model:  OAS 

Reports:  OPMR,  OASREP1 

Users:  DAPC 

:-OPD,  DAPC- 

PLF 

Maintainers 

,:  DAPC-OPD 

Programs:  0ASPRGUN01  , 

0ASPRGD0S1 

Input  file: 

OPDOASDATA 

Output  file 

:  OASOOT 

Element: 

INSPEC 

Element: 

ADSPEC 

Fields: 

grade 

Fields: 

name 

in spec ode 

grade 

commsv  r 

adspecode 

degrees 

yrssvc 

dor 

Element: 

CPMRECAP 

Element: 

0RATE85 

Fields: 

oct 

Fields: 

oct 

nov 

nov 

dec 

dec 

ian 
feb 

ian 
feb 

mar 

mar 

apr 

apr 

may 

may 

jun 

jun 

Jul 

Jul 

aug 

aug 

sep 

sep 

Aliases: 

OAS      ASSETER 

(JRATE85 

UTE? 

Categories: 

URATE85 

numeric 

OAS 

officer 

OASPRGUN01 

cobol 

0ASPRGD0S1 

development! 

Figure   4. 16        First   Example  of   Demonstration   Data 

used    in  describing   metadata    entities    lack    precision  and  need 
tightening    in    follow-on   efforts.      Precise    domains    need    be 
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Model:  P3M 

Reports:  EPMR,  P3MREP1 

Users:  DAPC-PLP,  DAPC-PLT,  DAPC-PLS 

Maintainers:  DAPC-PLF 

Programs:  P3MPR0GUNO1 ,  P3MPRCGD0S1,  P3MPR0GTRES1 


Input  file:  P3MDATA 

Element:  SEEPAGE84 

Fields:  mosto 
mosf 
e1  through  e8 


Element:  VALIDMOS 

Fields:  cmf 

etsyr 

etsmd 

tdatyr 

tdatmn 

bgrade 

egrade 

title 

Element:  AUTHCDR 
Fields:  e3  through  e9 


Output  file:  P3MOUTP0T1 
Element:  TNGPROG84 


Fields; 


si 
codes 

npstng 
pstng 


Element:  CRSLENATR84 


Fields:  wks 
att 


Aliases: 

P3M 

EIMMY 

P3M 

PAIN 

EPMR 

3PPER 

P3MPROGUN01 

PIMMY1 

P3MPROGDOS1 

PIMMI2 

Categories:  P3MPE0G[JN01  cobol 

P3MPR0GD0S1  fortran 


Figure  4.17    Second  Example  of  Demonstration  Data 

determined,  documented  and  enforced  by  edit  criteria. 
Refining  the  user* s  specification  of  metadata  will 
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facilitate  more  extensive  query  and  report  capabilities.   It 
is  only  possible  with  more  specific  domains  that  a  more  user 
friendly  query  interface  can  be  developed,  possibly  using 
artificial  intelligence  techniques.   Using  artificial 
intelligence  techniques  will  lead  to  a  more  useful  tool 
capable  of  assessing  the  impact  of  change  on  the  databases 
through  sensitivity  analysis  on  the  dictionary. 
Unfortunately,  the  prototype  version  is  not  "instrumented" 
to  capture  user  peculiarities   for  enhancing  friendliness 
and  performance.   Because  dBASE  II  was  used,  the  system 
suffers  poor  performance  in  comparison  to  what  would  be 
enjoyed  using  dBASE  III.   A  full  production  version  would  be 
inordinately  slow  if  not  implemented  in  dBASE  III. 
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Y.  CONCLUSIONS 

This  thesis  has  investigated  the  use  of  prototypes  and 
data  dictionaries  as  vehicles  fcr  assisting  requirements 
analysis.   It  has  explained  the  advantages  and  disadvantages 
of  prototypes;  provided  guidance  for  their  use;  explained 
tools  that  are  needed  and  provided  a  data  driven  approach  to 
prototyping.   It  has  shown  that  prototyping  is  a  useful 
adjunct  to  the  systems  development  life  cycle  and  is  most 
appropriately  applied  to  Management  Information  System 
applications.   The  most  significant  contribution  of 
prototyping  is  the  establishment  and  maintenance  of 
effective  communications  with  the  user  during  system 
development. 

This  thesis  has  shown  the  inportance  of  having  a  data 
dictionary  mechanism  to  capture  the  output  of  prototyping. 
Further,  it  has  explained  metadata  and  its  importance  in 
building  a  system  and  understanding  both  the  user's 
requirements  and  project  management's  requirements.   Clearly 
metadata,  like  user  data,  must  be  organized  into  a  database, 
a  data  dictionary  system.   Organization  of  a  data  dictionary 
can  be  in  accordance  with  one  of  many  different  data  models, 
but  the  relational  offers  the  mcst  promise  for  future  use. 
Consequently,  the  thesis  includes  a  prototype  relational 
dictionary  system. 

The  dictionary  system  demonstrates  the  feasibility  of 
using : 

1.  the  relational  model  for  a  data  dictionary. 

2.  micro-computers  in  a  prototype  effort. 

Although  of  limited  functionality,  the  prototype  was  quickly 
developed  and  offers  considerabJ;  flexibility  in  its  struc- 
ture to   serve  as   an  on-going   aid  in   developing  the   data 
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administration  function  in  the  user's  organization.  DDICT 
II  is  living  proof  of  the  viability  of  prototyping  with  data 
dictionaries  as  a  means  of  organizing  and  understanding  the 
data    and  user's   needs  in    system  development. 
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APPENDIX  A 
USER  MANUAL 

A.  INTRODUCTION 

This  manual  explains  only  what  is  necessary  to  get 
started  using  the  system.   The  system  is  self-prompting  and, 
therefore,  an  extended  narrative  is  unnecessary.   This 
manual  explains  the  use  of  both  the  demonstration  system  and 
the  actual  dictionary.  The  demonstration  system  resides  on 
floppy  disks  and  requires  a  different  initialization 
procedure.  If  you  are  using  the  demonstration  system, 
proceed  to  the  next  section.   If  you  want  to  use  the  actual 
installed  dictionary,  skip  to  section  C.   After 
initialization  both  systems  operate  identically  so,  upon 
completing  initialization,  proceed  to  section  D,  MAIN  menu. 

B.  INITIALIZING  THE  DEMONSTRATION  SYSTEM 

1.  If  the  system  is  on,  turn  it  off  and  remove  all 
floppy  disks. 

2.  Insert  the  floppy  disk  marked  'dBASE  II'  into  drive  A 
and  the  floppy  marked  'DEMONSTRATION1  into  drive  B. 

3.  Turn  on  the  system  (all  components:  computer,  monitor 
and  printer) . 

4.  Upon  being  prompted  for  the  date,  you  may  enter  it  in 
the  general  form:  MM-DD-YY  ,  or  simply  strike  the 
RETURN  key.  The  same  is  true  for  the  following  prompt 
for  the  time.  If  you  wish  to  have  the  current  time 
available  to  the  system,  the  general  form  of  your 
reply  is:  HH:MM 

5.  Upon  correctly  answering  the  time  and  date  prompts 
you  will  receive  the  following  on  the  screen: 
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A> 

6.  Now  type  in  'DBASE'  and  hit  the  RETURN  key. 

7.  You  will  hear  the  'A'  disk  drive  whirr  and  its  light 
come  on.   After  a  few  seconds  a  message  will  appear: 

Copyright  (C)  1982  RSP  Inc.   ***  dBASE  11/86  Ver  2.4 

I  July  1983 

• 

The  blinking  underline  character  following  the  period 
is  the  cursor.  The  period  is  the  prompt  used  by  dBASE 

II  and  indicates  that  you  have  accessed  the  dBASE  II 
software. 

8.  You  should  now  type  the  following  in  response  to  the 
prompt: 

SET  DEFAULT  TO  B: 

9.  Upon  receiving  the  period  prompt  you  are  now  ready  to 
use  the  demonstration  version  of  the  data  dictionary. 
At  this  point  proceed  to  section  D,  MAIN  menu. 

C.   INITIALIZING  THE  INSTALLED  DICTIONARY 

This  manual  assumes  that  the  user  is  familiar  with  the 
IBM  PC  sufficiently  to  start  it  up  and  move  to  the 
appropriate  working  directory  upon  which  the  dictionary 
system  is  installed.  For  the  purpose  of  this  manual  it 
assumes  that  directory  (disk  drive)  is  C.  Once  you  have 
moved  to  that  disk  you  are  ready  to  start  up  the  dbase  II 
software.   At  this  point  type  in  "dbase"  and  then  hit  the 
RETURN  key.   You  will  hear  the  "C"  disk  drive  whirr  and  its 
light  come  on.   After  a  few  seconds  a  message  that  reads  as 
follows  will  appear: 
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Copyright  (C)  1982  RSP  Inc.   ***  dBASE  11/86  Ver  2.4  1  July 
1983 

The  blinking  underline  character  following  the  period  is  the 
cursor.  The  period  is  the  prompt  for  dBASE  II  and  indicates 
that  you  have  the  accessed  dBASE  II  software.   Upon 
receiving  the  period  prompt  you  are  now  ready  to  use  the 
actual  version  of  the  data  dictionary.  Proceed  to  the  next 
section,  MAIN  menu. 

D.    MAIS  MEND 

Type  in  the  following  and  the  main  menu  for  the  data 
dictionary  will  appear:  DO  MAIN  (all  capital  letters  aren't 
necessary,  but  it's  best  for  this  particular  system  to  set 
the  "caps  lock"  key  so  that  you  are  always  in  uppercase.  To 
set  the  "caps  lock"  key  just  strike  the  key  so  marked  once) . 

The  MAIN  menu  permits  selection  of  the  major  function 
you  wish  to  perform.   Upon  selecting  a  major  function,  enter 
the  number  associated  and  another  menu  will  appear.   Please 
wait  for  the  "WAITING"  message  to  appear  before  typing  the 
number  of  the  major  function  you  want.   Upon  selecting  a 
major  function  another  menu  will  appear  (See  example  of  the 
Main  Menu  on  the  next  page) .   Use  the  instructions  of  this 
manual  for  working  with  those  menus.   After  a  period  of  use 
you  will  become  familiar  with  the  specific  functions  of  the 
system,  such  as  adding  a  model  record.   If  you  find  the  use 
of  the  menus  tedious  at  that  time,  you  can  execute  any 
specific  program  by  entering  "DC  program  name".  For 
example,  to  directly  execute  the  program  to  change  an  office 
record  you  would  enter  "DO  CHG-CFFICE".   To  help  you  learn 
the  specific  program  names  they  are  provided  in  the  menus  in 
parentheses  beside  the  explanation  of  a  choice.   This  means 
that  once  you  have  the  period  prompt  mentioned  above,  you 
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can  directly  accomplish  a  particular  function  by  executing 
the  associated  program  and  not  stepping  through  the  menus. 

This  is  the  MAIN  menu  for  the  data  dictionary  system. 
The   system  allows  you  to  add,  change,  or  delete  records  and 
to  process  queries.   Please  enter  the  number  of  the  function 
you  wish  to  perform: 

0  to  quit 

1  add  a  new  record  (ADD-MENU) 

2  change  a  record  (CHG-MENU) 

3  delete  a  record  (DEL-MENU) 

4  run  a  query  (QER?-MENU) 

5  print  a  report  (REPT-MENO) 

Enter  the  selection  here 
WAITING 

E.   ADD  SUBSYSTEM 

There  are  two  methods  of  accessing  the  ADD-MENO;  either 
by  typing  in  the  command  •DO  ADD-MENU*  or  by  selecting 
option  #1  from  the  MAIN-MENU.   In  either  case,  the  following 
menu  will  appear: 

ADD  MENU 

0  to  quit 

1  Model  (ADD-MOEEL)  5  File  (ADD-FI) 

2  Office  (ADD-OFFICE)  6  Element  (ADD-EL) 

3  Report  (ADD-REP)  7  Field  (ADD-FE) 

4  Program  (ADD-PRO)  8  Alias  (ADD-AL) 

9  Category  (ADD-CAT) 

Enter  the  selection  here 
WAITING  0 
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Selecting  0  from  the  ADD-MENO  will  return  you  to  either 
the  MAIN-MEND  or  a  blank  screen  (if  the  'DO  ADD-MENO' 
command  was  used). 

To  add  a  new  record,  press  the  number  associated  with 
the  entity's  type.  The  system  will  prompt  you  for  the  unique 
name  of  the  entity  you  wish  to  add.  If  that  name  is  not 
truly  unique,  the  system  will  tell  you  so  and  not  permit  you 
to  add  a  new  record.   If  the  name  is  unique  a  screen  will 
appear  with  the  fields  highlighted  to  include  blank  spaces 
for  entering  data  for  the  new  record.   Simply  fill  in  the 
appropriate  data  items  and  move  from  field  to  field  (DSING 
THE  CDRSOR)  until  you  have  filled  in  all  the  blank  fields 
for  which  you  have  data.   Once  you  have  assured  yourself 
that  all  data  items  you  have  entered  are  correct,  hit  the 
RETURN  key  and  the  record  will  be  added  to  the  database. 
(Note:  after  the  RETDRN  key  has  been  hit  changes  can  only  be 
made  using  the  CHANGE  subsystem) 

Once  you  have  entered  a  record  by  hitting  the  EETDRN  key 
you  will  be  prompted  if  you  wish  to  add  another  record  to 
the  database.   To  stop  adding  records,  hit  the  space  bar  and 
RETURN.   As  soon  as  the  RETDRN  key  is  hit  you  will  be 
returned  to  either  the  ADD-MEND  or  the  dbase  II  system. 

F.   CHANGE  SDBSYSTEM 

There  are  two  methods  of  accessing  the  CHANGE  menu  , 

either  typing  in  the  command  "DC  CHG-MENO"  and  striking  the 

return  key  or  selecting  option  2  from  MAIN  menu.   In  either 
case  the  CHG  menu  will  appear  as  follows: 

This  is  the  CHANGE  menu.  It  permits  you  to  change  records  in 
any  file.   Please  enter  the  number  of  the  function  you  wish  to 
perform. 

0  to  quit 

1  Model   (CHG-MODEL)  5  file  (CHG-FI) 
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2  Office    (CHG-OFFICE) 

3  Report    (CHG-EEP) 
U   Program    (CHG-PRO) 


6  Element     (CHG-EL) 

7  field     (CHG-FE) 

8  Alias     (CHG-AL) 

9  Category    (CHG-CAT) 


Enter  the  selection  here 

WAITING 

When  selecting  from   the  menu  always  wait  for   the  system  to 

prompt   you  with   the  words   "WAITING".     Selecting  0   will 

return  you  to  either  the  MAIN  menu  or  a  blank  screen  (if  the 

"DO  CHG-MENU"  command  was  used)  . 

Regardless  of  whatever  type  entity  you  wish  to  change, 
the  system  will  reguire  you  to  provide  the  entity's  unigue 
name.   To  guit  changing  records,  hit  the  space  bar  and 
RETURN.   The  system  will  then  find  the  record  for  that 
entity  and  present  it  on  the  screen  for  editing.   Having 
completed  the  editing,  the  record  can  be  stored  back  in  the 
dictionary  by  moving  the  cursor  down  through  tha  last  field 
using  the  RETURN  key.   If  there  are  any  relationships  for 
which  the  entity  is  an  object  of,  the  particular  program  you 
are  using  will  prompt  you  if  you  wish  to  add  or  delete 
entities  associated  with  the  one  you  just  changed.  For 
example,  if  you  edited  the  record  for  a  particular  FIELD, 
then  the  system  will  prompt  you  if  you  wish  to  add  or  delete 
verbal  type  records  for  ELEMENTS  that  contain  the  FIELD.   A 
change  in  the  unigue  name  of  an  entity  will  be  automatically 
changed  in  all  verbal  type  records  for  you  by  the  software. 
For  example,  if  you  changed  the  unigue  name  of  a  FIELD  the 
software  will  change  all  CONTAINS  records  accordingly  for 
you. 
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G.   DELETE  SOBSTSTEH 

There  are  two  methods  of  accessing  the  DELETE  menu  , 
either  typing  in  the  command  "DO  DEL-MENU"  and  striking  the 
return  key  or  selecting  option  3  from  MAIN  menu.   In  either 
case  the  DELETE  menu  will  appear  as  follows: 

This  is  the  DELETE  menu.  It  permits  you  to  delete  records 
from  any  file.  Please  enter  the  number  of  the  function  you 
wish  to  perform. 

0  to  quit 

1  Model  (DEL-MODEL)  5  File  (DEL-FI) 

2  Office  (DEL-OFFICE)  6  Element  (DEL-EL) 

3  Report  (DEL-REP)  7  Field  (DEL-FE) 

4  Program  (DEL-PRO)  8  Alias  (DEL-AL) 

9  Category  (DEL-CAT) 

Enter  the  selection  here 
WAITING 

Select  the  type  entity  you  wish  to  delete  by  entering  the 
number  associated  with  the  entity's  type.  The  particular 
program  selected  will  prompt  you  for  the  unique  name  of  the 
entity.  To  quit  deleting  records,  hit  the  space  bar  and 
RETURN,  otherwise  type  in  the  name  and  hit  RETURN.  If  you 
have  given  the  unique  name  correctly,  the  system  will  find 
that  entity's  record  and  ask  if  you  are  sure  that  is  the  one 
you  wish  to  delete.  If  you  answer  Y,  the  system  will  delete 
the  associated  record,  not  merely  mark  it  for  deletion. 
Further,  the  system  will  automatically  delete  all  associated 
verbal  type  records  for  the  particular  entity  deleted.  For 
example,  if  you  chose  to  delete  the  FIELD  named  Grade,  and 
that  field  is  contained  in  the  ELEMENT  Aspec,  then  all  the 
CONTAIi,  records  showing  Aspec  as  containing  the  field  will 
also  be  deleted. 
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H.   QUERY  SUBSYSTEM 

There  are  two  methods  of  accessing  the  QUERY  menu, 
either  by  typing  in  the  command  "DO  REPT-MENU"  and  striking 
the  return  key  or  selecting  option  4  from  the  MAIN  menu.   In 
either  case  the  QUERY  menu  will  appear  as  follows: 

This  is  the  QUERY   menu.  It  permits  you   to  make 
ad-hoc  inquiries.   Queries  are  either  of  the 
•forward'  type  where  an  entity  is  the  subject  and 
you  specify  the  verb  and  object,  or  of  the  'backward' 
type  where  the  entity  you  give  is  the  object  of  an 
action  and  subject. 

QUERY  MENU 

1)  Forward  type  (i.e.  P3M  calls  what  programs  ?)   (FORTREV) 

2)  Backward  type  (i.e.  P3M  is  used  by  what  offices  ?)  (BAKTREV) 

3)  Forward  type  for  aliases  (  indicate  type  and  system 
provides  all  aliases)  (F0RA1) 

4)  Backward  type  for  aliases  (give  entity  name  and  system 

(BAKA1)   provides  all  aliases  for  that  particular  entity) 

5)  Forward  type  for  categories  (indicate  type  and  system 

gives  categories)  (FORCAT) 

6)  Backward  type  for  categories  (give  entity  name  and 
(BAKCAT)     system  gives  all  categories  that  entity  is  in) 

0  to  quit 

Enter  the  selection  here 

WAITING  0 

The   system  provides   two   types  of  gueries,    forward   and 

backward.    Forward  means   the  user  is  presented   columns  of 

relations  from  which  to  pick.     The  columns,   following  the 

forward  flow  of  the  English  language,  are  subject,   verb  and 
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object  respectively.  The  user  provides  the  unique  name  of 
the  entity  beside  its  type  in  the  subject  column;  then  marks 
one  appropriate  entry  in  the  verb  column  and  one 
appropriate  entry  in  the  object  column.  For  example,  to 
answer  the  question  "What  models  does  the  office  with  symbol 
DAPC-PLF  use  ?"  see  Figure  A. 1  which  depicts  how  the  screen 
of  the  FORTREV  program  would  appear  and  Figure  A. 2  depicts 
the  output.  Verb  and  object  choices  must  be  appropriate  for 
the  subject  in  that  it  is  not  possible  to  get  any  response 
from  a  query  marked  for  which  there  is  no  relationship 
defined.  For  example,  marking  the  screen  of  the  FORTREV 
program  to  answer  the  question  "What  models  contain  what 
fields    ?   "    would    elicit  no    response    when    processed. 


SUBJECTS  VERBS  OBJECTS 


Of fice:DAPC-PLF      :  Uses:X:  Reports:    : 

Maintains:    :  Models:X: 

Model:  :  Calls:    :  Programs:    : 

Inputs:    :  Files:    : 

Outputs:    : 

File:  :  Elements:    : 

Contains:    : 
Element:  :  Fields:     : 

To   quit   put    an    X      in    this    field    :     : 

Put    the    unique    name  of    the    entity    you   are   querying    about 

in    the   field    next    to    the    entity's    type.       Then    place    an   X 

in    one   appropriate   verb   field  for    that   entity    type   and 

an    X    in    1    appropriate   object   field. 

I.E.    Office :DAPC-PLF        :  Uses:X:  Models:X: 

To   process   query    move   cursor    through    remaining 

fields   using    RETURN  key. 


Figure    A. 1         Example   of   a   Forward   Retrieval 
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The   office   DAPC-PIF  uses      the  following    models 

P3M 
OAS 

Strike  any  key  to  continue- . . 

WAITING 


Figure  A. 2    Example  of  Forward  Query  Output 

The  backwards  approach  is  implemented  by  presenting, 
from  left  to  right,  columns  of  objects,  verbs  and  then 
subjects.   Thus,  to  answer  a  question  such  as  "What  offices 
use  the  P3M  model  ?"   the  screen  of  the  BAKTREV  program 
would  be  marked  as  shewn  in  Figure  A. 3  and  Figure  A. 4 
depicts  how  the  output  from  this  query  would  appear. 
Because  the  ALIAS  and  CATEGORY  relations  are  each  a  special 
case,  they  are  given  their  own  respective  forward  (F0RA1  5 
FORCAT)  and  backward  (BAKAL  &    BAKCAT)  query  programs. 

I-   BEPOBTS  SUBSYSTEM 

There  are  two  methods  of  accessing  the  BEPORT  menu, 
either  by  typing  in  the  command  "DO  REPT-MENU"  and  striking 
the  RETURN  key  or  selecting  option  5  from  the  MAIN  menu.  In 
either  case  the  menu  will  appear  as  follows: 
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OBJECTS 

Model: P3M 
Report: 


Program: 
File: 


Element: 
Field: 


VERBS 

Is  used  by:X 

Is  maintained  by: 

Is  called  by: 

Is  inputted  by: 

Is  outputted  by: 

Is  contained  in: 


To  quit  put  an  X  in  this  field: 


SUBJECTS 


Dffice:X 

Model: 

File: 
Element:  : 


Enter  the  name  of  the  entity  besides  its  type  and  then 

mark  1  verb  field  and  1  subject  field.   To  process 

query  move  cursor  down  through  remaining  fields 
using  RETURN  key. 


Figure  A. 3    Example  of  a  Backward  Retrieval 


1  ■ 

■  i 

The  model 

P3M 

is 

used 

by 

the 

follow 

ing 

offices 

DAPC-PLP 
DAPC-PLT 
DAPC-FIS 
DAPC-PLF 

Strike  any 
WAITING 

key 

to 

cont 

inue 

, ,, 

Figure  A. 4    Output  From  a  Backwards  Query 
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This  is  the  REPORT  menu.  It  permits  you  to  print 
summary  reports  from  the  dictionary. 

REPORT  MENU 

1)  for  a  specific  Model  all  users,  maintainers, 
input  5  output  files,  programs  called   (SUMOD) 

2)  for  a  specific  Report  all  users  and  models  outputting  it 

(SUMREP) 

3)  for  a  specific  Office  all  models  used,  all 
models  maintained,  and   reports  used.     (SUMOFF) 

4)  for  a  specific  File  all  models  it  provides  input  to, 
receives  output  from,  and  elements  it  contains   (SUMFIL) 

0  to  quit 

Enter  the  selection  here 
WAITING 

Before  executing  any  Report  menu  option  be  sure  the 
printer  is  both  turned  on  and  is  "on  line".   Failure  to  have 
the  printer  turned  on  may  result  in  your  being  thrown  out  of 
the  data  dictionary  system  and  dBASE  II  and,  therefore,  to 
reinitialize.   Select  the  report  program  you  wish  to 
execute.  The  system  will  then  prompt  you  for  tha  unigue  name 
of  the  entity  concerned.   For  that  specific  entity,  the 
system  will  then  provide  a  printed  summary  report  which 
provides  all  entities  which  have  a  direct  relationship  with 
the  entity.   Thus,  if  the  you  provide  the  unique  name  of  a 
Model,  the  printed  report  would  list: 

1 .  All  offices  which  use  the  Model. 

2.  All  offices  which  maintain  the  Model. 

3.  All  programs  the  Model  calls. 
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4.  All  reports  the  Model  outputs. 

5.  All  files  the  Model  either  inputs  from  or  outputs  to. 
For  example,  if  you  wished  to  have  a  summary  report  about 
for  the  P3M  model  you  would  select  option  1  from  the  Reports 
menu  for  execution  of  the  SUMOD  program.  The  system  would 
then  prompt  you  as  follows: 

Please  enter  the  unique  name  of  the  Model 
Hit  the  space  bar  and  RETURN  to  guit:P3M 


The    Model      P3 M 

Is    used   by    the    following    offices: 

DAPC-PLP 
DAPC-PLT 
DAPC-PLS 
DAPC-PLF 

Is    maintained    by    the    followicg    offices   with 
the   point   of    contact: 

DAPC-PIF      KALINICH 

Inputs   the    following    files: 

P3MDATA 

Outputs  to  the  following  files: 

P3M0UTPUT1 

Outputs  the  following  reports: 

EPMR 
P3MREP1 

Calls  the  following  programs 

P3MPR0GUN01 
P3MPR0GD0S1 
P3MPE0GTRES1 

Strike  any  key  to  continue 
WAITING 


Figure  A. 5   Example  of  Report  Output 
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J.   TEBHIHATIHG  A  SESSION 

Having  completed  whatever  wcrk  you  wished  to  accomplish, 
you  will  now  want  to  shut  down  the  dictionary  system. 

1.  If  you  have  a  menu  up  on  the  screen,  select  "0"  and 
exit.   If  another  menu  appears,  exit  in  the  same 
manner.   You  will  now  have  the  period  prompt  on  the 
screen  iniicating  you  are  out  of  the  dictionary 
system. 

2.  Type  in  the  word  "QUIT"  and  hit  the  RETURN  key. 

3.  If  you  are  using  the  demonstration  system  you  will 
get  the  following  prompt: 

A> 

If  you  are  using  the  installed  system  you  will  get 
the  following  prompt: 

C> 

4.  If  you  were  using  the  installed  system,  turn  off  the 
machine  and  you  are  done.   If  you  were  using  the 
demonstration  system,  remove  the  floppy  disks  and 
store  them  in  their  paper  sleeves. 
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APPENDIX    B 
DATA    DICTIONARY    SYSTEM'S    DATA    ELEMENTS 

The   following    is  an    alphabetic    listing   of   the    fields 
used    in   the   dictionary  system.      An  asterisk   following   a  file 
name    denotes  the    field   being   discussed    as    being    key    to    that 
file. 

dBASE    II   FIELD    NAME    /  ACRONYM:       aname 

FULLNAME:    alias    name 

FORMAT:    mixed 

LENGTH:     15 

FILES  WHERE  USED:  Alias 

DESCRIPTION:  Name  by  which  any  entity  is  known 
other  than  its  official  name. 

dBASE  II  FIELD  NAME  /  ACRONYM:  tldg 

FULLNAME:  building 

FORMAT:  mixed 

LENGTH:  15 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  building  in  which  an  office 
is  located. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cat 
FULLNAME:  category 
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FORMAT:  alphabetic 

LENGTH:  16 

FILES  WHERE  USED:  Category 

DESCRIPTION:  The  category  in  which  an 

entity  would  be  placed  such  as  a  field  being  a 

continuation  rate. 

dBASE  II  FIELD  NAME  /  ACRONYM:  comments 

FULLNAME:  comments 

FORMAT:  mixed 

LENGTH:  45 

FILES  WHERE  USED:  office 

DESCRIPTION:  Any  narrative  information 
that  illuminates  on  the  office  cccaring 
in  the  record. 

dBASE  II  FIELD  NAME  /  ACRONYM:  datatype 

FULLNAME:  datatype 

FORMAT:  alphabetic 

LENGTH:  3 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  type  of  data  that  a  field  could 

hold.  The  entry  can  be  either  A  for  alphabetic, 

N  for  numeric,  AN  for  both  or  S  for  special. 

For  example,  for  a  field  that  could  hold  all  three 
this  eDtry  would  be  ANS. 

dBASE  II  FIELD  NAME  /  ACRONYM:  date 
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FULLNAME:  date 

FORMAT:  numeric 

LENGTH:  6 

FILES  WHERE  USED:  Element 

DESCRIPTION:  This  is  date  an  element  was  created. 

dBASE  II  FIELD  NAME  /  ACRONYM:  description 

FULLNAME:  description 

FORMAT:  alphabetic 

LENGTH:  45 

FILES    WHERE   USED:    Report,    Model,    Program, 
File,    Element,    Field 

DESCRIPTION:    Verbal    narrative   illuminating   on  the 
entity   it  is  associated    with. 

dBASE    II   FIELD    NAME    /  ACRONYM:     domain 

FULLNAME:    domain 

FORMAT:    mixed 

LENGTH:     45 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  range  of  acceptable  values 
a  field  can  take  on. 

dBASE  II  FIELD  NAME  /  ACRONYM:  editcri 

FULLNAME:  edit  criteria 

FORMAT:  mixed 

LENGTH:  45 
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FILES  WHERE  DSED:  Field 

DESCRIPTION:  Rules  used  to  constrain  and 
edit  what  values  can  occur  in  a  field. 

dBASE  II  FIELD  NAME  /  ACRONYM:  elname 

FULLNAME:  element  name 

FORMAT:  mixed 

LENGTH:  12 

FILES  WHERE  USED:  Element* 

DESCRIPTION:  Unique  name  of  file  element  (not  a  data 
element  or  field,  but  the  partition  of  a  file). 

dBASE  II  FIELD  NAME  /  ACRONYM:  ename 

FULLNAME:  entity  name 

FORMAT:  mixed 

LENGTH:  15 

FILES  WHERE  USED:  Alias*,  Category *, Contains, 
Calls,  Uses,  Outputs,  Inputs,  Alias 

DESCRIPTION:  The  unicue  name  associated  with  an 
entity  such  as  what  could  legally  occur  in  mdl 
for  a  Model.  This  value  would  be  the  object 
of  one  of  the  verb  relations. 

dBASE  II  FIELD  NAME  /  ACRONYM:  enamel 

FULLNAME:  entity  name  #1 

FORMAT:  mixed 

LENGTH:  15 


81 


FILES  WHERE  OSED:  contains*.  Outputs*,  Inputs*, 
Calls* 

DESCRIPTION:  The  unique  name  associated  with  an 
entity  and  the  subject  of  a  vert  relation. 


dBASE  II  FIELD  NAME  /  ACRONYM:  etype 

FULLNAME:  entity  type 

FORMAT:  alphabetic 

LENGTH:  10 

FILES  WHERE  USED:  Contains,  Outfuts,  Inputs, 
Calls 

DESCRIPTION:  Type  of  entity  that  ename 
specifies  such  as  Model,  Report,  etc. 

dEASE  II  FIELD  NAME  /  ACRONYM:  etypel 

FULLNAME:  entity  type  #1 

FORMAT:  alphabetic 

LENGTH:  10 

FILES  WHERE  OSED:  Contains*,  Outputs*, Inputs*, 
Calls* 

DESCRIPTION:  Type  of  entity  that  enamel  is 
specifying  such  as  Model,  Report,  etc. 

dBASE  II  FIELD  NAME  /  ACRONYM:  tld 
FULLNAME:  field 


FORMAT:  mixed 

LENGTH:  15 

FILES  WHERE  USED:  Field* 

DESCRIPTION:  The  unique  name  of  a  field. 

dBASE  II  FIELD  NAME  /  ACRONYM:  fname 

FULLNAME:  file  name 

FORMAT:  mixed 

LENGTH:  16 

FILES  WHERE  USED:  File* 

DESCRIPTION:  The  unique  name  of  a  file. 

dBASE  II  FIELD  NAME  /  ACRONYM:  fullname 

FULLNAME:  full  name 

FORMAT:  mixed 

LENGTH:  25 

FILES    WHERE   USED:    Report,    File 

DESCRIPTION:    The   non-unigue    and   fully    expanded 
name   of    either   a   report   or   file. 

dBASE    II   FIELD    NAME    /  ACRONYM:     language 

FULLNAME:    language 

FORMAT:    mixed 

LENGTH:     10 

FILES    WHERE   USED:    Program 
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DESCRIPTION:  The  computer  language 
a  program  is  written  in,  such  as 
FORTRAN  77. 

dBASE  II  FIELD  NAME  /  ACRONYM:  lstupdate 

FULLNAME:  last  update 

FORMAT:  numeric,  YYMMDD 

LENGTH:  6 

FILES  WHERE  USED:  File 

DESCRIPTION:  The  most  recent  date  of 
a  file  having  been  updated. 

dBASE  II  FIELD  NAME  /  ACRONYM:  length 

FULLNAME:  length 

FORMAT:  numeric 

LENGTH:  3 

FILES  WHERE  USED:  Field 

DESCRIPTION:  The  size  of  a  field  in  bytes. 

dBASE  II  FIELD  NAME  /  ACRONYM:  location 
FULLNAME:  location 
FORMAT:  mixed 
LENGTH:  16 

FILES  WHERE  USED:  Model,  Program 
DESCRIPTION:  The  file  where  a  program  or  model 
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is  stored  on  the  computer. 

dBASE  II  FIELD  NAME  /  ACRONYM:  mdl 

FOLLNAME:  model 

FORMAT:  mixed 

LENGTH:  8 

FILES  WHERE  USED:  Model*,  Maintains* 

DESCRIPTION:  The  unique  abbreviation  or  acronym 
associated   with  a  Model. 

dBASE  II  FIELD  NAME  /  ACRONYM:  media 

FOLLNAME:  storage  media 

FORMAT:   alphabetic 

LENGTH:  10 

FILES  WHERE  USED:  File 

DESCRIPTION:   The  type  medium  used  to  store 
a  file,  i.e.  tape  or  disk. 

dBASE  II  FIELD  NAME  /  ACRONYM:  method 

FULLNAME:  methodology 

FORMAT:  alphabetic 

LENGTH:  15 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  Operations  Research  solution 
techniques  used  by  a  model  such  as  Linear  Programming. 
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dBASE    II    FIELD    NAME    /  ACRONYM:     uodelpoc 

PULLNAME:    model    point  of   contact 

FORMAT:    alphabetic 

LENGTH:     15 

FILES  WHERE  USED:  Maintains 

DESCRIPTION:  The  individual  to  te  contacted 
regarding  maintanance  of  a  model. 

dBASE  II  FIELD  NAME  /  ACRONYM:  nodname 

FULLNAME:  model  name 

FORMAT:  mixed 

LENGTH:  30 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  fully  expanded,  non-unique 
name  of  a  Model. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cullstat 

FULLNAME:  nullstatus 

FORMAT:  alphabetic 

LENGTH:  1 

FILES    WHERE    USED:    Field 

DESCRIPTION:    Indicates    whether    a   field   can    have 
the    null   status    or    some    value    must   always   be 

present. 

d3ASE    II   FIELD    NAME    /  ACRONYM:     number 
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FULLNAME:  number 

FORMAT:  mixed 

LENGTH:  9 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  number  assigned  to  a  report  by 
the  computer  operations  organization  Df  MILPERCEN, 

dBASE  II  FIELD  NAME  /  ACRONYM:  cfc 

FULLNAME:  office  symbol 

FORMAT:  alphabetic 

LENGTH:  9 

FILES  HHERE  DSED:  Office*,  Uses* 

DESCRIPTION:  The  unique  symbol  which  identifies 
an  office  of  either  DCSPLANS  or  some  other 
organization,  for  example  PERSINSD. 

dBASE  II  FIELD  NAME  /  ACRONYM:  cname 

FULLNAME:  office  name 

FORMAT:  mixed 

LENGTH:  35 

FILES    WHERE    USED:    File 

DESCRIPTION:    The    expanded,    non-unique   name    of   an 
office,    such   Deputy    Chief   of    Staff    for   Plans 
for    DCSPLANS. 

dBASE    II    FIELD    NAME    /   ACRONYM:     outfrmat 
FULLNAME:    output    format 
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FORMAT:  alphabetic 

LENGTH:  15 

FILES  WHERE  USED:  Report 

DESCRIPTION:  The  form  a  report  takes  such  as  hard  copy, 
tape,  or  microfice. 

dBASE  II  FIELD  NAME  /  ACRONYM:  phone 

FULLNAME:  telephone  number 

FORMAT:  mixed 

LENGTH:  21 

FILES  WHERE  USED:  Office 

DESCRIPTION:  The  telephone  number  of  an  office. 
dBASE  II  FIELD  NAME  /  ACRONYM:  pname 

FULLNAME:  program  name 

FORMAT:  alphabetic 

LENGTH:  15 

FILES  WHERE  USED:  Program* 

DESCRIPTION:  The  unigue  identifier  of  a  program. 

dBASE  II  FIELD  NAME  /  ACRONYM:  periodicity 

FULLNAME:  periodicity  of  entity 

FORMAT:  mixed 

LENGTH:  U 

FILES    WHERE  USED:    Report,    Model,    Program 

DESCRIPTION:    How   frequently    a   report,    program, 
or   model   is   executed    or   produced.      Coded    by 
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a  number  and  then  the  time  period.  For  example, 
2W  means  twice  monthly,  3Q  means  thrice  quarterly. 

dBASE  II  FIELD  NAME  /  ACRONYM:  foe 

FULLNAME:  point  of  contact 

FORMAT:  alphabetic 

LENGTH;  15 

FILES  WHERE  USED:  Office,  File,  Element,  and 
Field 

DESCRIPTION:  The  individual  to  be  contacted  if 
having  problems  or  need  information  about 
the  associated  entity. 

dBASE  II  FIELD  NAME  /  ACRONYM:  purpose 

FULLNAME:  purpose 

FORMAT:  alphabetic 

LENGTH:  45 

FILES  WHERE  USED:  Report,  Model,  Program, 
File,  Field,  and  Element 

DESCRIPTION:  The  function  and  reason  for 
existence  of  an  entity. 

dBASE  II  FIELD  NAME  /  ACRONYM:  rname 

FULLNAME:  report  name 

FORMAT:  mixed 

LENGTH:  10 

FILES    WHERE   USED:    Report* 
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DESCRIPTION:  The  unique  identifier  of  a  Report. 

dBASE  II  FIELD  NAME  /  ACRONYM:  seqnum 

FULLNAME:  sequence  number 

FORMAT:  numeric 

LENGTH:  5 

FILES  WHERE  USED:  Element 

DESCRIPTION:  Location  of  an  element  within 
the  file  that  holds  it.   Elements  are 
both  named  and  marked  by  their  sequential 
position  in  the  file. 

dBASE  II  FIELD  NAME  /  ACRONYM:  room 

FULLNAME:  room  number 

FORMAT:  mixed 

LENGTH:  6 

FILES  WHERE  USED:  Office 

DESCRIPTION:  Room  where  an  office  is  located. 

dBASE  II  FIELD  NAME  /  ACRONYM:  runame 

FULLNAME:  run  stream  name 

FORMAT:  mixed 

LENGTH:  15 

FILES  WHERE  USED:  Model 

DESCRIPTION:  The  unique  name  of  a  ri   stream  (Job 
Control  Language  procedure)  that  res -_ts  in 
Model  being  executed. 
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dBASE  II  FIELD  NAME  /  ACRONYM:  size 

FULLNAME:  size 

FORMAT:  numeric 

LENGTH:  3 

FILES  WHERE  DSED:  Element 

DESCRIPTION:  Length  in  bytes  of  an  occurrence  in  an 
element.  All  occurrences  in  an  element  are  the  same  size 
and  the  format  of  the  element  is  likened  to  a  record. 

dBASE  II  FIELD  NAME  /  ACRONYM:  seclass 

FULLNAME:  security  classif icaticn 

FORMAT:  alphabetic 

LENGTH:  2 

FILES  WHERE  USED:  Report,  Field 

DESCRIPTION:  Highest  level  of  classified 
information  the  entity  contains.   Coded 
as  0",  C,  S  or  TS. 

dEASE  II  FIELD  NAME  /  ACRONYM:  source 

FULLNAME:  source 

FORMAT:  mixed 

LENGTH:  15 

FILES    WHERE    USED:    Field 

DESCRIPTION:    The   document    or   source 
which   explains    or   specifies    what   values 
can    occur   in   a    field.    For   example, 
AR    6  11-201    specifies    what   would    occur   in   a 
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field  for  enlisted  military  occupational 
specialty. 

dBASE  II  FIELD  NAME  /  ACRONYM:  status 

FULLNAME:  development  status 

FORMAT:  alphabetic 

LENGTH:  15 

FILES  WHERE  USED:  Report,  Model,  Program, 
File,  Field 

DESCRIPTION:  The  development  status  of  in  entity  such  as 
test,  operational,  retired. 

dBASE  II  FIELD  NAME  /  ACRONYM:  version 

FULLNAME:  version 

FORMAT:  numeric 

LENGTH:  3 

FILES  KHERE  OSED:  Program* 

DESCRIPTION:  The  edition  number   f  a  program  and 
therefore  an  indicator  of  unigu^.ess.  For  example, 
ADSPEC3. 
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